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Preface 


This document presents an overview of Sun Microsystems’ hardware product 
family, operating system software, application oriented software, and technical 
documentation. This book is a guide; it tells you what is available and where to 
find more information. It is not a tutorial or a ‘ ‘how to” guide for any of the 
software. 


Who Should Read This Book 


Contents of Chapters 


You should read this book if: 

□ you are considering the purchase of a Sun workstation(s) and want to know 
what is available; 

□ you already have purchased a Sun workstation, or your boss dropped one on 
your desk and you don’t know where to start; and, 

□ you are new to the SunOS operating system or any of the Sun software. 

The chapters in this manual include: 

□ Chapter 2, Sun Product Family, presents an overview of the workstation sys¬ 
tems. 

□ Chapter 3, SunOS — User Features, describes the SunOS, and discusses the 
major features of the SunOS operating system. 

□ 4, Sunview — A Window Environment, describes the user and programming 
interfaces of the SunView window environment. 

□ 5, Using the Shells, discusses the shells. The shell is the principal command 
interface for SunOS system utilities. 

□ Chapter 6, User Access and Commands, describes how to gain access to the 
system and its application software. 

□ Chapter 7, Working with Files, discusses the facilities for working with files 
and for using the hierarchical file system. 

□ Chapter 8, Editing Text Files, describes the programs used for creating, edit¬ 
ing, and manipulating text. 

□ Chapter 9, Formatting Documents, covers the application software for pro¬ 
ducing documents. 


Preface — Continued 


□ Chapter 10, Communication Facilities, describes the local area network 
facilities and the remote communication facilities. 

□ Chapter 11, SunOS—Internal Features, describes the programming inter¬ 
faces to the SunOS operating system. 

□ Chapter 12, System Administration, describes the tools for the system 
administrator. 

□ Chapter 13, Software Development, describes the programming languages 
and language tools that are standard in the SunOS system, and discusses pro¬ 
gramming tools for debugging and maintaining software. 

□ Chapter 14, Graphics Software, describes an overview of Sun’s graphic 
libraries. 

□ Chapter 15, Unbundled and Third Party Software, contains pointers to avail¬ 
able unbundled products, the Catalyst third-party software program and the 
Sun Users’ Group. 

a Chapter 16, Sun Technical Documentation, describes the organization of the 
Sun suite of technical manuals. 



Introduction 


Introduction. 

1.1. Basic Hardware 

1.2. Basic Software 










Introduction 


The Sun workstation is a high-performance, bitmapped workstation complete 
with a monochrome or color screen display, a keyboard, and mouse pointing dev¬ 
ice. The workstation is oriented for applications in engineering. Computer Aided 
Design (CAD), Computer Aided Manufacturing (CAM), Computer Aided 
Engineering (CAE), Computer Aided Publishing (CAP), graphics, software 
development, etc. 

There are three families of Sun workstations: the Sun-4 series, the Sun-3 series 
and the Sun386i. Each workstation in these three families is described in this 
manual. All three families of workstations run the SunOS operating system. 

1.1. Basic Hardware The Sun-4 family of workstations are built around the Scalable Processor 

ARChitecture (SPARC). SPARC is a RISC architecmre; a style of computer 
architecture designed for simplicity and efficiency. 

The Stm386i family uses an AT bus and a private 32-bit interconnect. 

The Sun-3 family of workstations is built around the Motorola MC68020 proces¬ 
sors and the high-speed 32-bit VMEbus. The monochrome and color displays 
have 1152 by 900 pixels. The display screen has its own memory — the frame 
buffer providing high-speed data transfer to the screen. 

1.2. Basic Software The SunOS operating system is a heavily enhanced version of the 4.2 BSD and 

4.3BSD UNIX system derived from the University of California at Berkeley. It 
also includes features of AT&T, System V.3 UNIX, coupled with other Sun 
enhancements. The SunOS operating system provides: 

□ a host of software as a base level package; 

□ support for C and assembler languages; 

□ tools for software development applications; 

□ utilities for performing statistical text processing and for document prepara¬ 
tion. 

o a virtual memory management scheme; 

□ a shared library facility; and, 

□ support for interprocess communication and local area networking. 
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To these basics, Sun Microsystems has added a user interface package. This 
package is based on overlapping windows, and a comprehensive library of graph¬ 
ics packages to support the more common graphics standards. 

The remainder of this book introduces the Sun family of workstations and 
features/applications of the SunOS operating system. 
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Sun Product Family 


The Sun family of workstations are built around industry standard chips, bus 
architectures, and network architectures. 

□ The Sun-4 family of supercomputing workstations use Sun’s implementation 
of RISC technology, the Scalable Processor ARChitecture (SPARC). 

□ The Sun386i family uses an AT bus for user-expandable I/O, and a private 
32-bit interconnect. 

□ The Sun-3 family of workstations are based on the MC680x0 processors and 
the high-speed 32-bit VMEbus. 

The Sun-4 and Sun-3 families of workstations use the Sun Operating System 
(SunOS), a heavily enhanced version of 4.2BSD and 4.3BSD UNIX. The 
Sun386i uses an extended version of the SunOS operating system. 


An earlier family of Sun worksta¬ 
tions, the Sun-2 family, is still sup¬ 
ported, but unavailable for pur¬ 
chase, The Sun-2 family is based 
on the MC680x0 processors, and 
can be upgraded to the new SunOS 
system. 


The Sun-4, Sun386i, and the Sun-3 families of workstations include mono¬ 
chrome and color workstations with a wide choice of peripheral equipment. 

Numerous configurations are possible in the Sun-4, Sun386i, and Sun-3 families, 
such as standalone workstations with disk and tape, servers on a network, and 
diskfuU or diskless workstations on a network. The Sun-4 and Sun-3 families 
also include rack-mountable configurations. 


2,1, Sun-4 Product Family The Sun-4 family of supercomputing workstations use Sun’s RISC technology 

SPARC. SPARC is source-code compatible with Sun’s current Sun-3 family of 
workstations. SPARC architecture provides mainframe-equivalent power (10- 
MIPS) to the Sun-4 workstations. 


Suii-4/200 Series The Sun4/200 series offers workstations with high-resolution pixel density 

screens (Sun 4/260HM), a workstation with a monitor which can simultaneously 
present 256 colors from a palette (Sun 4/260C), and a workstation with specially 
enhanced graphics capabilities (Sun4/260CXP). 

These workstations (and others in the 4/200 series) can be configured in 
numerous ways from standalone workstations, to network-servers with up to 2.3 
gbytes of mass storage. 
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Sun-4/110 System The Sim-4/110 is a supercomputing desktop machine also based on SPARC 

architecture. It is a 7-MIPS machine, for applications such as artificial intelli¬ 
gence and computer-aided software engineering. The Sun-4/110 can use 
software running on other Sun-4 machines without change, and with some 
modification, can use software running on Sun-3 and Sun-2 workstations. 

The Sun386i workstations, based on Intel’s 80386 microporcessor,-ran the 
SunOS operating system and are source-compatible with the Sun-4 and Sun-3 
product lines. In addition, the Sun386i systems feature integrated DOS func¬ 
tionality, and an AT-compatible bus. Ease-of-use features built into the Sun386i 
system include: 

□ factory-installed system software; 

□ automatic network installation; 

□ context-sensitive help; and, 

□ window-based system and network administration. 

Each Sun386i workstation includes a SCSI disk, 1.44 MB diskette, Ethernet, and 
an Intel 80387 floating point processor. Sun386i systems can be configured as 
diskless, diskfuU, or server workstations. 

Sun386i/150 The Sun386i/150 workstation contains 4 MB of memory, expandable to 8,12, or 

16 MB, and runs at 20 MHz. 

Sun386l/250 The Sun386i/250 workstation contains 8 MB of memory, expandable to 12 or 16 

MB, and runs at 25 MHz. 

2.3, Suii-3 Product Family The Sun-3 product family, like the Sun-4 family, run the SunOS operating sys¬ 
tem. The Sun-3 product family, however, is based on the Motorola MC68020 
chip and the high-sp«ed 32-bit VMEbus. 

Sun-3/60 Series The Sun-3/60 can te used as a general-purpose workstation or server. It is a 3- 

MIPS machine with a range of monitor options. This workstation is used for 
CAD/CAM, AI delivery and computer-aided publishing. 

Sun-3/200 Series This series of Sun workstations are 4-MIPS machines and are available with 

color, grayscale or the same high-resolution monochrome screen of the Sun-4 
family. The Sun-3/200 series are used for artificial-intelligence development, 
electrical and mechanical CAD, and rapid software prototyping. 

Sun-3/100 Series The Sun-3/100 series is a midrange line of workstations and servers. These 

machines provide 2-MIPS of performance and offers a wide array of solutions for 
technical professionals. 

Sun-3/50 Series The Sun-3/50 runs at 1.5 MIPS and can be configured as a machine for a net¬ 

work, or as a standalone workstation. This machine is valuable for applications 
in software engineering, computer-aided design, and computer-aided publishing. 


2.2. Sun386i Product 
Family 
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2.4. Sun-3 Optional 
Hardware 


2.5. Pictures of Sun 
Machines 


Desk Top Systems 



Desk Side Systems 


Optional hardware for the Sim-3 family includes a floating point accelerator. The 
floating point accelerator conforms to IEEE754 standards for floating point cal¬ 
culations and is useful for engineering applications, MCAD, ECAD, architectural 
computer-aided design, and scientific research. 

There are also workstations which enhance graphics processing. The Sun- 
3/160CXP and the Sun-3/260CXP improve performance for 2-D and 3-D 
transformations, clipping, scaling and rendering. 

All Sun workstations and servers share the following standard features: 

□ a keyboard and mouse pointing device (optional for all servers); 

□ ethemet 10 Mbits/sec local area network interface; 

□ two RS-423 serial ports with modem control; and, 

□ 8-bit color on all color systems. 

The pictures below shows desk top and desk side Sun machines. 

The desk top Sun workstation can be assembled in two different ways. 

□ The first type of desk top Sun is a diskless machine serviced by the network 
for files, data, etc. 

□ The second type of desk top Sun is a workstation with a local disk. This 
type of machine can act as a standalone or can also sit on a network. Gen¬ 
erally, a workstation with a local disk is a three slot machine containing 
memory and hardware. 

Sun machines which can be configured as desk top systems include: 

□ in the Sun-4 family of workstations, the Sun-4/1 lOM, Sun-4/1 lOFC, and the 
Sun-4/1 IOC; 

□ in the Sun386i family of workstations, the Sun386i/150 and the 
Sun386i/250. 

□ in the Sun-3 family of workstations, the Sun-3/50, Sun-3/60 series, and the 
Sun-3/100 series, except the Sun-3/140S to Sun-3/180S systems. 

The desk side Sun system has faster and more powerful processors. It typically 
is configured with a disk and six or twelve slots for adding more memory or 
hardware. 
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Sun systems which can be configured as desk side systems, include: 

a in the Sun-4 family of workstations include the Sun-4/260HM, Sun-4/260C, 
Sun-4/260CXP, and the Sun-4/260G; 

□ in the Sun-3 family of workstations include the some workstations from the 
Sun-3/100 series, and workstations from the Sun-3/200 series except the 
Sun-3/260S and the Sun-2/80S. 


File Servers 



A file server is used for exporting files. Generally, it is configured with a disk 
and acts as a file server for an individual or a small number of people. 

Systems used as file servers include: 

□ in the Sun-4 family of workstations, the Sun-4/1 lOS and the Sun-4/260S. 

□ in the Sun-3 family of workstations, the Sun-3/140 to Sun-3/1 SOS, and the 
Sun-3/260S. 


Rack-Mountable File Servers 



The rack-mountable file server supports high volumes of disks. It is not a works¬ 
tation, but a system for servicing network file service (NFS) requests and up to 
about ten diskless workstations. 

Systems used as file servers, include: 

□ in the Sun-4 family of workstations, the Sun-4/280S; 

□ in the Sun-3 family of workstations, the Sun-3/180S. 
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3.3. User Interface — Window System. 

3.4. Command Interface — C Shell 

















SunOS — User Features 


The SunOS operating system is based upon the UNIX operating system as 
derived from the University of California, Berkeley 4.2 and 4.3 systems. It also 
includes features of AT&T System V.3, and other Sim enhancements. The 
SunOS operating system is a virtual memory system. This chapter presents the 
basic user features of the system, including the hierarchical file system, the 
hierarchical file system in the network, and the user interface features — the Sun- 
View Window system, and the C shell command interpreter. 

3.1. Hierarchical File The hierarchical file system is used to store and to retrieve data. It is the most 

System visible aspect of the SunOS operating system. At the user (command) level, the 

basic object whichyou manipulate is a file. A file is a collection of data, such as 
words, characters, numbers, and attributes that are stored together. The most 
important attribute is the file’s name. 

The hierarchical file system groups related files within a directory. A directory is, 
itself, simply a special file. A directory can contain other directories as well as 
files and can be grouped within directories to arbitrary limits in the SunOS 
operating system. The figure below represents a file system containing direc¬ 
tories and files for both tfie system and several users: 
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The SunOS hierarchical file system 
differs from most UNIX systems. 
The SunOS filesystem makes 
administration for disk and diskless 
machines easier since the file sys¬ 
tem is consistent for disk/diskless 
machines and server/non-server 
machines. 


The following is a brief description of the system directories in the hierarchical 
file system. 

□ The root (/) directory is a small directory, with files that do not change often. 

□ The export directory contains files of aU exported files for diskless clients. 

□ The etc directory contains database files pertinent to each machine. 

□ The sbin directory contains files used for booting the system. 

□ The var directory contains files that change often. This directory was 
created to control files that grow. 

□ The home directory includes server and user directories. 

For more information see Getting Started with SunOS: Beginner’s Guide and the 
hier and filesystem manual pages. 
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3.2. The Hierarchical File The SunOS operating system extends the file system concept a major step further 

System in the Network with the Network File System. The Network File System, (NFS), is a facility for 

transparently sharing files in a heterogeneous environment of machines, operat¬ 
ing systems, and networks. Sharing occurs by mounting a remote filesystem, 
then reading or writing files in place. The network file system avoids duplicating 
resources since each machine in a network does not maintain its own file sys¬ 
tems. 

In the network file system, a file system does not need to be physically present on 
a local disk or on your own areas of your server. File systems are mounted from 
other machines in the network, as weU as from disks attached to the local 
machine. Once mounted, a remote file system appears as part of the existing file 
system hierarchy. 

In the network, a machine that provides resources to the network is called an 
NFS server, while a machine that employs these resources is called an NFS 
client. A machine may be both a server and a client. A user logged in on a client 
machine is a user, while a program or set of programs running on a client 
machine is an application. 

The figure below shows three workstations with their public /usr file systems 
mounted from a NFS server. All file transfers take place over the underlying net¬ 
work. 
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Yellow Pages Network Service For machines on a network there is certain information such as password, group, 

network, host information, etc. that should be the same for each machine. The 
Yellow Pages (YP) is a replicated, read-only, database service, used to administer 
this information. The Yellow Pages replicates this information on multiple 
machines, making the information highly available for server and client 
machines. If a server crashes, a client machine can find the information on 
another server. 

For more information on the file system. Network File System, and the Yellow 
Pages, see Using the Network: Beginner’s Guide, and System Services Overview. 
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The SunOS operating system user interface uses a combination window system 
and command interface for doing work on the system. The SunView window 
system is based on multiple overlapping windows which provides a ‘desktop’ 
environment. Instead of typing commands, objects are manipulated using a 
pointing device called a mouse. 

The SunView facility is described in further detail in chapter 3, SunView—A 
Window Environment. For further information see SunView 1 Beginner’s Guide 
and SunView 1 Programmer’s Guide. 

3,4. Command Interface — The command interface uses the C shell command interpreter. The shell is the 

C Shell principal command-oriented interface to the operating system and utilities out¬ 

side of the window- and mouse-based user interface. The shell reads and inter¬ 
prets user commands, passes the interpreted commands to the appropriate utility 
software, and waits for the command to finish before accepting another com¬ 
mand. 

The C shell was implemented by Bill Joy at the University of California, Berke¬ 
ley. On Sun systems the C shell is normally used for interactive use. Another 
standard shell available on the SunOS is the Bourne shell named after its creator, 
S. R. Bourne. 

The C shell is a powerful interactive command interpreter. Major features of the 
C shell are listed below. 

□ Background and foreground running of jobs. 

□ Displaying the status of jobs. 

□ Maintaining a history of user commands both during a login session and 
across login sessions. A history list can be displayed and previous com¬ 
mands can be accessed either by event number or by the first few unique 
characters of the command. Substitutions can be made to repeated com¬ 
mands. 

□ Tailoring command sets using the C shell alias facility — a macro-like facil¬ 
ity providing synonyms for commands. 

□ Tailoring the command environment using the C shell startup facilities for 
setting standard features of the environment such as the path the shell fol¬ 
lows for locating commands. 

o The C shell can be used as a programming language. Sequences of com¬ 
mands are placed in a file and the command sequences is executed just by 
typing the name of the file. The programming features of the shell can per¬ 
form often complex tasks without creating new software. 

For further information see chapter 5, Using the Shells, Getting Started with 
SunOS: Beginner’s Guide, Doing More with SunOS: Beginner’s Guide, and the 
csh manual page. 


3.3. User Interface— 
Window System 
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SunView — A Window Environment 


SunView — the Sun Visual/Integrated Environment for workstations is a 
window-based user environment which uses the capabilities of a high-resolution 
bit-mapped screen. 

SunView has two interfaces; a user interface and a programming interface, 

□ The user interface is an environment of multiple, overlapping windows 
which appear on the workstation screen. The window environment is 
created with the sun view command. You can run a variety of window- 
based tools in SunView, and some of these tools let you run standard SunOS 
utilities. Each tool is a separate, independent application, and each window 
runs user tasks independent of the other windows on the screen. 

□ The programming interface is accessible through a collection of subroutine 
libraries. There are three major levels in the programming interface to Sun¬ 
View, and a programmer can use any or aU of these three layers to write 
applications. 

4.1. Window User Interface The user interface of SunView is a collection of software utilities that use the 

graphical capabilities of the Sun hardware. The mouse (a pointing device) is a 
primary mechanism for interacting with the tools. Application software displays 
control panels with buttons that you ‘click-on’ with the mouse, and sliders 
(potentiometers) that you adjust with the mouse. 

Windows occupy sections of the screen and can overlap each other. You can 
move windows around on the screen. You can move a window to the top of the 
pile by pointing at it, or you can move a window to the bottom of the pile. You 
can adjust the size of a window depending upon your needs. You can ‘close’ a 
window so that it occupies a minimum amount of the real-estate on the screen. 
When a window is closed it becomes an ‘icon’ — a small graphical object whose 
appearance sometimes suggests its function. The following picture depicts a typ¬ 
ical screen with overlapping windows and some icons. 
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Figure 4-1 Typical Screen with Overlapping Windows and Icons 






/hunies/roseni/sun.systtiin.uvervieiii/ScrBBn.DiJiip^ 


(from "The Old Man and the C") 

ilt was winter and that made the typing good. He liked to 
type. He liked to type quick and clean and hard, and see 
the words form on the screen. They were like droplets of 
ijwater on a window pane, small and dark. But they weren''t 
liquid. They were words, 
jhaybe they're not like drops after all. 


f he workstation hummed and as it hummed he thought of Mari: 

he workstation reminded him of Maria. They were both 
[expensive and sat on his desk a lot, but the workstation 
[had a better memory than Maria did. She would ask him 
about the .cshrc files over and over. Over and over again 
[until the words were not words, but were like little dropl^- 
on a pane of glass. 

i|He had new mai 1. 

[She had been sitting in Harry's, dressed in blue tafeta 
jthat was somehow not blue tafeta, sipping an absinthe. 

IJThat had been May and Florence and a new start but now it 
j|was January and he had bunions and his office mate had 
the brain of a zither, and in two weeks there was a 
deadline. Not like the deadlines he had known back home. 
iThose deadlines were hard and sure and swift. These 
iLiere like Melted Pudding. 
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return(FALSE); 


is_man(roads) 
int roads; 

c 

int is_man; 


/* see if he's walked enough roads to be a man */ 


is_jiian = FALSE; 

if (roads >= MANS_ROAD_NUMBER) 
is_man = TRUE; 
return(is_man); 


walk_road(rtype) 
char *rtype; 


/* kind of road to be walked down */ 


c 

int 


road_no; 

if (strcmp(rtype, "Rough and pebbly") == 0) 
road_no = 2; 

else if (strcmp(rtype, "Uphill and full of thorns") == 0) 
road_no = 3; 

else if (strcnip(rtype, "Littered with the corpses of liberals") == 0) 
road_no = 6; 

else 

road_no = 1; 
return(road_no); 


venusl60: 


IfThis was the Hard Way. 
not Man Pages. 


It was tough. At least it was 


uenus896; 

composite 

composite. 

composite. 

venus897; 

venus897: 

venus897: 


Is 

vec 

pic 

snap 


harrys2 

harrys_I 

harrys_II 


macros 

maternity 

reviews 


spam_make* 

spam_use 

sparacan 


spamit 

spamit2 

te.dit 


warning 

writers 

xref_lore 


D 


mm 
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You can manipulate text in a window by using the mouse and clicking-on but¬ 
tons or menu items. One application is to select text in one window and ‘paste’ it 
into the input stream of another window — this forms the basis of ‘cut and paste’ 
style editing. 

For more information on using SunView and its applications see SunView 1 
Beginner’s Guide. 


4.2. SunView Tools A major part of the SunView environment is the tools available for numerous 

applications. A tool is a shell, editor, or other application that runs in SunView. 
Some of the available tools of SunView include: 

□ command tool (cmdtool), 

□ shell tool (shelltool). 
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□ text editor (textedit), 

□ defaults editor (defaultsedit), 
o icon editor (iconedit), 

□ front editor (fontedit), 

□ mail tool (mailtool), 

□ Dbx (debug) editor (dbxt oo 1), 

a performance meter (perfmeter), 

□ clock (clocktool), 

□ lock screen (lockscreen), 

Each of these tools is described below. A sample tool frame and tool icon 
representation accompany each description. 
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Command Tool 



Figure 4-2 


Command Tool (cmdtool) is a command interpreter that displays a standard 
SunView text-based command window with scrolling. It is an enhancement 
designed to replace Shell Tool. Command Tool can do everything that Shell 
Tool does, but it offers scrolling and a full Text menu. 

An example of a Command Tool frame follows. 

Command Tool Frame 


candtooi - 7bin/csh 


venus% Is *.doc 


patrick_henry.doc sched.doc 

venus'A head -3 patrick_henry.doc 

I don't know why they always misquote me about liberty, 

What they say I said ain't what I said at all. 

Here are some of the remarks I've made recently on the subject. 

Venus'/, fgrep -n "Give me liberty" ’*.doc 

patrick_henry.doc:4iGive me liberty or I'll give you what-for. 
patrick_henry.doc:5:Give me liberty or I'll give you a piece of my mind, 
patrick_henry.doc:7:Give me liberty or give me a salami on rye. 
patrick_henry.doc:8;Give me liberty or give me a raise. 
patrick_henry.doc;9;Give me liberty or give me a free lunch. 
patrick_henry.doc:10iGive me liberty or give me a break. 
patrick_henry.doc:11:What I want for my birthday is: Give me liberty. 
patrick_henry,doc:12:You know what I always say—Give me liberty! 
patrick_henry.doc:13:Give me liberty or I'll go on strike. 

patrick_henry.doc:14:"Give me liberty" seems to lose its meaning after a while. 
patrick_henry.doc:15iMaybe the boy who cried wolf really cried, "Give me liberty 
I" 

venus'/. cp patrick_henry.doc 1iberty.doc 
venus'A Is "“.doc 

liberty,doc patrick_henry.doc sched.doc 

^ venus'/. get_se lection | cat 

If liberty is all it's cracked up to be, gimme scxne. 

Give me more 
and more 
and more 
1 and more 
and more 
and more 
venus'/. 


For more information on Command Tool see SunView 1 Beginner’s Guide and 
the cmdtool manual page. 
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Shell Tool 

Shell Tool (shelltool) is a a window-based interface to the standard SunOS 
operating system command interpreters (shells). The following is an example of 
a Shell Tool frame. 


Figure 4-3 Shell Tool Frame 


shelltool - /bin/csh 


venus% Is *.doc 

liberty.doc patrick_h 0 nry.doc sched.doc 

venus% head -3 patrick_henry.doc 

I don't know why they always misquote me about liberty, 
i^hat they say I said ain't what I said at all. 

Here are scnne of the remarks I've made recently on the subject. 
venus% fgrep -n "Give me liberty" "'.doc 
1iberty.doc:4:Give me liberty or I'll give you what-for. 

1iberty.doc;5:Give me liberty or I'll give you a piece of my mind. 

1iberty.doc:7:6ive me liberty or give me a salami on rye. 
liberty.doc:8:Give me liberty or give me a raise. 

1iberty .doc :9:Give me liberty or give me a free lunch, 

1iberty.doc:10:Give me liberty or give me a break. 

1iberty.doc:11:What I want for my birthday is: Give me liberty. 

1iberty.doc:12:You knew what I always say—Give me liberty! 

1iberty.doc:13iGive me liberty or I'll go on strike. 

1iberty,doc:14;"Give me liberty" seems to lose its meaning after a while. 

1iberty.doc:15iMaybe the boy who cried wolf really cried, "Give me liberty!" 

patrick_henry.doc:4;Give me liberty or I'll give you what-for. 

patrick^henry.doc:5;Give me liberty or I'll give you a piece of my mind. 

patrick_henry.doc:7;Give me liberty or give me a salami on rye. 

patrick_henry.doc:8;Give me liberty or give me a raise. 

patrick_henry.doc:9;Give me liberty or give me a free lunch. 

patrick_henry.doc:10:Give me liberty or give me a break. 

patrick_henry.doc:11iWhat I want for my birthday is; Give me liberty. 

patrick_henry.doc:12:You know what I always say—Give me liberty! 

patrick_henry.doc: 13.'Give me liberty or I'll go on strike. 

patrick_henry.doc: 14;"Give me liberty" seems to lose its meaning after a while. 
patrick_henry.doc:15iMaybe the boy who cried wolf really cried, "Give me liberty 
I" 

venus% rm liberty.doc 
rm: remove liberty.doc? y 
venus'/o [] 



For more information on Shell Tool see SunView 1 Beginner’s Guide and the 
shelltool manual page. 
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Console 



console 


The Console is a special Command Tool that displays error messages and other 
information from SunView and the SunOS operating system. An example of a 
Console frame is shown below. 


Figure 4-4 Console Frame 


« CONSOLE » 


Default settings assumed. 
venus% 


For more information see the cmdt ool manual page. 
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Text Editor 



bedtime. 


The Text Editor (textedit) is a mouse-based text editing tool to create and to 
review text files. There are mouse functions to select regions of text, and func¬ 
tions to perform cut and paste operations. An example of a Text Edit frame is 
shown below. 


Figure 4-5 Text Editor Frame 


textedit - bedtimG_story, dir: /home/nutmeg/sages 


^|Jcratch^^_umd^:_Vbedtime^tor^ 


A Bedtime Story 


Once upon a time there was a beautiful queen in a city by the 
sea. The queen was as good as she was beautiful, and all her 
subjects loved her. The city she ruled had fresh air, good harvests, 
and the blessings of peace. There was just one problem: the 
ccmiputers were always down! 

The baker said to the customers, "How can I tell if there's 
rye bread in the oven? My computer is dcmnl" 

The blacksmith said to the stable owner, "How can I tell if 
your horses will be shod next Tuesday at 3:00? My computer is down!" 

The quality of life in the city by the sea grew worse and 
worse. The queen sat on a balcony of the castle, looking down on her 
unhappy subjects, and she thought, and she thought, and she thought. 
All of a sudden she leaped from her bench. 

"I know," she cried, "I will make a network!" 

So she called in experts frcm all over the world. They 
I brought powerful magic scrolls full of words like "abracadabra" and 
"coaxial cable" and "multiplexor box," and they unrolled the scrolls 
jand chanted before the queen. And as they chanted, all the computers 
in the city by the sea began to talk to one another. 


"I'll trade you a dozen bagels for a pony ride,' 
jbaker's computer to the stable owner's computer. 


said the 


"I'll meet you in the orchard when the moon rises," said the 
[carpenter's conputer to the schoolteacher's computer. 

All the people of the city gathered before the castle 
rejoicing. They looked up at the queen, who beamed down upon them 
from her balcony, and they shouted, "The net works! Long live the 
queen!" 

The queen ruled for many years, and the computers never went 
down again, and they all lived happily ever after. 

The End 


For more information on Text Editor see SunView 1 Beginner’s Guide and the 
textedit manual page. 
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Defaults Editor 


n n 

FAULTS 


The Defaults Editor is a tool for customizing SunView. You can change default 
settings of SunView to create an environment comfortable for you. An example 
of a Default Editors frame is shown below. 

Figure 4-6 Defaults Editor Frame 



Category 0SunView 

[Savei [Quit] [Reset] 

[Edit Item] 

Get HELP by clicking the 

left button on the appropriate label 

or string 


Click_to_Type 
Font 

Walking_Menus 
Root*enu_f 1 lename 
Icon_gravity 
Icon_c1ose_1eve1 
jLinp_cu rso r_on_ resize 
Alert_Bel1 
Audible_Bel1 
VisibleBel1 
Etnbol denLabel s 
Ttysubhii ndou/Retai ned 
Root_Pattern 

Conf i rtiiPropertyChanges 


(Disabled): Q Disabled 

(Enabled): OEnabled 

(): /usr/vieu/1.75/usr/lib/rootmenu 
(North); Q North 
(Ahead_of_al 1); Q Ahead_of_al 1 
(Disabled); Ql Disabled 
( 1 ); 

(Enabled); O Enabled 
(Enabled): O Enabled 
(Disabled); O Enabled 


(on); 
(Disabled); 


Disabled 


For more information on Defaults Editor see SunView 1 Beginner’s Guide and 
the def aultsedit manual page. 
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Icon Editor 





The Icon Editor (iconedit) is a window-based drawing editor for designing 
icons and cursor images. An example of an Icon Edit frame used to draw the Sun 
logo is shown below. 

Figure 4-7 Icon Edit Frame 



For more information on Icon Edit see SunView 1 Beginner’s Guide and the 
iconedit manual page. 
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Font Editor 


X 


The Font Editor tool (font edit) creates and edits fonts. You load a font and 
select a portion of that font to be displayed in the eight smaU windows. Two 
characters at a time may be selected for editing. These characters are displayed 
in large format so you can make pixel-by-pixel modifications to them. A Font 
Editor frame is shown below. 


Fi sure 4-8 Font Editor Frame 


fontedit 


Press and hold button to uipe points. 


fLoad) [Store] [Quit] Font name: /usr/1ib/fonts/fixeduidthfonts/serif,r. 
Max Width: 7 Max Height: 14 

Caps Height: 10 X Height: 7 Baseline: 10 [AppTy"] | 

Operation; OSingle Pt HPtWipe QLine Q Rect 0 Cut 13 Copy B Paste 




For more information on the Font Editor see SunView 1 Beginner’s Guide and 
the fontedit manual page. 
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Mail Tool 

Mail Tool (mailtool) provides windows for sending and for receiving mail. 
You can use the standard text facilities of SunView (textedit) to compose 
messages and to move text between messages. A Mail Tool frame is shown 
below. 

Figure 4-9 Mail Tool 



mailtool - folder: -fbugs 


57 To marthaSwashington 

58 marthaeuashington 

> 59 abigaiISadams 


Fri Oct 9 13:36 
Fn' Oct 9 14:01 
Thu Oct 15 09:47 


7? messages 2B neu 


35/1127 Church Po 
29/885 Re: Chur 
54/2162 A Most Gr 


f Shou) K Hext~~][ Delete ]f Reply )fComposeJ { Print "^fNeuj Mail) 
[ Save ~] [ Folder ] File: +bug^ [ M1sc ][ Done ] 


To;' dony@madison. 

Subject; A Most Grievous and Unfortunate Circimstance 
Dearest Dolly, 

Knowing your intimate friendship with the wife of General 
Washington, I write to tell you of a most scandalous situation, 

I am informed that the young men at the pub!ieke house have been 
mocking the good general regarding his iron teeth. 

Do have a word with James, and if it is true, try to discover 
whether Martha can gently persuade the great man to try 
porcelain or gold instead. 


[Include](Deliver]( Clear D(E -addres^ 


CStay Up 


To; marthaSwashington 

Subject: How George May Be Aided in His Publicke Appearances 
Bcc: abigaiISadams 

Dearest Martha, 

Thee oughtest talk to George about his false teeth. 

My husband tells me the men at Fraunces Taverns 
spoke most unkindly of his appearance there, 

Such a great general and statesman as he 

deserves better treatment at the hand of his dentist. 


For more information on Mail Tool see Mail and Messages: Beginner’s Guide 
and the mailtool and mail manual pages. 
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Dbx Tool 



The Dbx Tool (dbxtool) is a source-level debugger for C, Pascal and Fortran 
77 programs. To use dbxtool, you point to the object you want to operate on 
(say display the value of a variable) and then you ‘push a button’ to get the 
operation done. Below is an example of a Dbx Tool Frame. 


Figure 4-10 Dbx Tool Frame 


Awaiting Execution 

File Displayed: ./example.c _ 

I struct few few2 =■ { 3, 4, NULL, "world" } j 

struct few fewl •= { 1, 2, &few2, "hello" } ; 

* write a main program to use the structures 

mainO 

* declare the variable *fewp 
* to p[oint to a few-type structure 

struct few *fewp; 

/♦ 

* print out a message 

f for (fewp - &fewl; fewp !- NULL; fewp -> next) { 

printf("%s ", fewp -> message); 


Lines: 13-32 


print jfprint 


step jlstop at][ cont j[stop inj[ clear ][ where 
up down ir Fun 1 


t Reading symbolic information... 

S Read 155 symbols 
(dbxtool) run 
Running; example 
hello world 

execution canpleted, exit code is 0 
program exited with 0 
(dbxtool) stop at "example.c":29 
(2) stop at "example.c":29 
(dbxtool) print fewp 
"fewp" is not active 
^ (dbxtool) ^_ 


For more information on Dbx Tool see Debugging Tools and the dbxtool and 
dbx manual pages. 
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Performance Meter 


cpu IS© 


Performance Meter (perfmeter) is a tool for observing system performance. 
The icon for measuring performance is a speedometer-like gauge with a needle 
that moves as system conditions change. There are numerous options that you 
can measure with this tool such as processor performance, network performance, 
memory performance and I/O performance. For more information on Perfor¬ 
mance Meter see SunView 1 Beginner’s Guide and the per f me ter manual 
page. 
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Clock Tool 



Clock (clocktool) displays the date and time in the forni of a clock on the 
screen. The display can be customized in various ways: 

□ round or square clock, 

□ Arabic or Roman numerals on the clock face, 

□ display the seconds, 

□ display the day of the week. 


I XI XII 1 j 


II 

IX 1 

1 III 

Vlil 

III! 

VII ^ 

'l V 


The Qock Frame displays the day, fuU date with year and the current time. An 
example of the Clock Frame appears below. 

Figure 4-11 Clock Frame 






Fri Oct 9 11:16:22 1987 


For more information on Qock Frame see SunView 1 Beginner’s Guide and the 
date manual page. 


4.3. Programming SunView has a programming interface for building window-based applications. 

Interface The programming interface is a collection of function libraries. Since SunView 

is based on SunWindows which is based on Pixrects, an application can also 
make calls to SunWindows and Pixrect functions. This hierarchy is described in 
the figure below. 
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4.5. SunWindows Facilities 


Pixrects 


Further Reading 


The building blocks for creating application software include: 

□ text subwindows for displaying textual data; 

□ canvas subwindows for displaying graphical information; 

□ scrollbars for scrolling backward and forward in a file; 

□ control panels containing ‘pushbuttons’ for selecting actions; 

□ menus to display choices for the user to select; and, 

□ alerts which display information, instructions, errors, and confirmations. 

There is a general-purpose mouse-oriented text facility (textedit) with func¬ 
tions to select, extend, cut, and paste. 

SunWindows facilities include the basic window manager and window display 
package. 

The Pixrect graphics library is a set of RasterOp routines common among all Sun 
workstations. With these routines, application programs can be written that 
access the display on aU Sun products. In the Sun graphics software world, the 
Pixrect library is a low-level package, sitting on top of the device drivers. 

For more information on programming the Sun Window System see SunView 1 
Programmer’s Guide, SunView I System Programmer’s Guide, and Pixrect 
Reference Manual. 
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Using the Shells 


The SunOS operating system uses the SunView window system as an interface 
for user input. A program called the shell is used as a command interface for 
doing work on the system. As you type commands to the shell it reads and inter¬ 
prets the commands, passes the interpreted commands on to be performed, and 
waits for each copimand to finish before proceeding to the next. 

Currently, there are two shells used on the SunOS operating system: 

□ the C shell, developed by William Joy at the University of California at 
Berkeley; and, 

□ the Bourne shell, named after its developer S.R. Bourne. The Bourne shell 
is the standard UNIX system shell. 

The shell is a command interpreter and a programming language, and both shells 
can serve either purpose. The C shell, however, has more useful features for 
interactive use, such as command aliasing, job control, and a history mechanism. 
The Bourne shell, while providing fewer interactive features, runs faster and has 
a simpler syntax for writing shell programs. 

Many similarities exist in the user interface for both shells. The major differ¬ 
ences between the shells lie in the internal programming interface and the alias¬ 
ing, job control, and history features offered only by the C shell. 

The following user interface features are provided by both shells: 

o Command line analysis. When a command is typed at the command fine, 
the shell accepts and interprets the command you typed. The shell then runs 
the command, passing the remainder of the command line as arguments to 
the command. Each command is run as a separate process. Most of the time 
commands run in the foreground, or “while you wait”. But, commands also 
can be run in the background. During a background process the shell returns 
immediately so you can continue typing more commands while it processes 
the command running in the background. 

□ Redirection. By default commands use input from the keyboard and output 
data and error messages to the terminal. Redirection enables you to manipu¬ 
late standard input, standard output, and standard error to or from files, 
rather than from default locations. The process of directing standard input, 
output and error from commands to files is called ‘redirection of standard 


5.1. User Interface 

Features of the Shells 
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input and output’. 

□ Pipelines. Pipelines connect the standard output from one command to the 
standard input of the next command. New commands can be built by con¬ 
necting (or piping) UNIX commands together. 

□ Filename expansion. Both shells use metacharacters to identify file and 
directory names. The metacharacters include: 

? matches any single character in a filename. 

* metacharacter matches any string of characters (including the empty 
string) in a filename. For example, * On its own matches all files in a 
directory. 

[ ] metacharacters form character classes that indicate ranges of letters or 
digits in filenames. For example, [ a-m] * matches all files starting 
with the letters a through m. 

□ Search path. A user-settable path to locate commands is available in both 
shells. This path is generally defined in a ‘ ‘startup” file and executed during 
log in. Along with defining a search path, other features can be included in 
this profile file to tailor the environment to your special needs. 

For further details on the user interface features of the shells, see Getting Started 
with SunOS: Beginner’s Guide, Doing More with SunOS: Beginner’s Guide, and 
the csh or sh manual pages. 

5.2. Programming Features Besides acting as a command interface, both shells also can be used as program- 

of the Shells ming languages. Programs created using the shell programming language are 

called shell scripts. 

A shell script is a file containing a sequence of commands. When the filename is 
typed as a command to the system, the commands in the file are read and then 
sequentially executed. Shell scripts are quickly created, debugged, and executed 
because there is no need to run a compiler and loader and recompile to change 
things. Shell scripts frequently provide a good first cut for an application when 
using the shell programming features and connecting existing UNIX system com¬ 
mands together. Shell scripts provide for what is often called rapid prototyping 
for applications. 

The following are programming features common to both shells: 

□ setting and accessing variables; 

o substituting arguments from the command line; 

□ if ... then ... else constructs for conditional execution of commands; 
o case switches for selecting groups of commands; 

□ while loops for executing groups of commands iteratively; 

p for loops for executing groups of commands over lists of files or variables; 

□ break, continue and exit to get out of looping constructs; and, 
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□ features for taking action on traps and interrupts. These features are used to 
do ‘clean up’ action if a shell process is interrupted. 

For further details on programming features of the shells, see Doing More with 
SunOS: Beginner’s Guide and the csh and sh manual pages. 

5.3. The Shells The SunOS operating system includes the C shell and the Bourne she!. 


C Shell The C shell command name is c sh. On Sun systems users normally use the C 

shell for interactive use. The C shell was developed at the University of Califor¬ 
nia, Berkeley as part of the 4.2BSD operating system. 


Another type of shell available on 
the Sun system is the remote shell, 
rsh. This shell is used to execute 
commands on other systems. The 
rsh can be either a C shell or a 
Bourne shell. For more information, 
see the rsh manual page. 

□ A history substitution mechanism used with the history mechanism 
described above. Parts of previous commands can be substituted either sin- 
glely, or globally. 

□ A job control feature suspends jobs and switches a job back and forth 
between the foreground and the background. Foreground jobs can be sent to 
the background and background jobs can be brought to the foreground. You 
can determine which jobs are running and kill them if required. 

o An alias mechanism creates and renames commands. 

□ A feature to optionally announce the presence of mail as it arrives in the sys¬ 
tem. 

The major programming features of the C shell include: 

□ a programming syntax resembling the C programming language; and, 

□ the ability to compose compound commands using the shell’s internal pro¬ 
gramming constructs. 

For further information, see the manual Doing More with SunOS: Beginner’s 

Guide and the csh manual page. 


The C shell provides a flexible user interface. Its major external features include: 

□ A history facility to reissue previous commands. The shell maintains a his¬ 
tory buffer of the last n commands, where n is specified by the user. The 
history list is displayed or commands in the history list are referred to by 
their event number in the list or by searching for substrings of the actual 
name of the command. 


Bourne Shell The Bourne shell command name is sh. The Bourne shell is the standard UNIX 

system version 7 command language interpreter, but is used generally on Sun 
systems for creating shell scripts. The Bourne shell is named after its originator, 
S. R. Bourne from Bell Laboratories. The Bourne shell has most of the same 
external features as the C shell, but lacks a history facility, a job-control facility, 
and a history substitution facility. 

The major programming features of the Bourne shell include: 

□ internal programming features modeled after the Algol-68 programming 
language; 
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□ support for 8-bit non-ASCII characters for commands and their arguments; 
and, 

□ a school of thought that maintains that writing shell scripts is easier and fas¬ 
ter with the Bourne sheU. 

For more information, see the manual Doing More with SunOS: Beginner’s 
Guide and the sh manual page. 


5.4. Related Shell Utilities 


Text Manipulating Utilities 


There are numerous tools or utilities used to make shell programming easier. 
These tools generally are divided into two basic categories; text manipulating 
utilities and tools which are extensions of the control structure of the shell pro¬ 
gramming language. 

The following list describes some of the basic utilities used for manipulating text 
when creating shell scripts. 


Displaying Command Line 
Arguments 


Making Shell Scripts 
Executable 


Breaking Lines Apart 


Putting Lines Together 


Complex Editing 


Pattern Searching 


Translating Characters 


The echo command displays (or echoes) the remainder of its command line. It 
is used for diagnostics or prompts in shell programs, or for inserting data into a 
pipeline. For further details see Doing More with SunOS: Beginner’s Guide and 
the echo manual page. 

The chmod command changes permissions on files. This command is used to 
make script files executable programs. For further details see Doing More with 
SunOS: Beginner’s Guide and the chmod manual page. 

The cut command extracts selected fields of data from lines in a file. The cut 
command is useful for cutting out columns from tables or fields from a line in a 
file or from the output of a command. For further details see the cut manual 
page. 

The paste command merges corresponding lines from files to form a single 
line. For further details see the paste manual page. 

The sed utility is a stream editor used for creating complex global substitutions 
in pipelines, sed can not be used interactively. For further details see the sed 
manual page and the ed manual page for information on regular expressions. 

The grep command is part of a family of pattern searching commands, used to 
locate particular patterns of characters in files. For further details see Getting 
Started with SunOS: Beginner’s Guide, Doing More with SunOS: Beginner’s 
Guide, and the grep manual page. 

The tr command changes one character into another. For further details see the 
tr manual page. 


Control Structure Extensions The following is a list of utilities used to extend the shell’s control structures. 
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Conditional Testing 


Evaluating Expressions 


Waiting on Process 

Suspending Execution 
Blocking Hangups 


Changing Priority 
Killing Processes 
Scheduling Actions 


Diverting Output 


The test command tests data for use in shell conditionals. Features of the 
test utility include: 

□ string comparison; 

o determining the nature of a file (is it a directory, file, link, symbolic link, and 
so on), and the file’s accessibility (is it readable, writeable, executable, and 
so on); and, 

□ Boolean combinations of the above. 

For further details see Doing More with SunOS: Beginner’s Guide and the test 
manual page. 

The expr command evaluates expressions that appear on its command line as 
arguments. Features of the expr utility include: 

□ string computations; 

o integer arithmetic; and, 

□ pattern matching. 

For further details see Doing More with SunOS: Beginner’s Guide and the expr 
manual page. 

The wait command waits for termination of asynchronously running processes. 
For further details see the wait manual page. 

The sleep command suspends a command execution for a specified time. For 
further details see the sleep manual page. 

The nohup command is used mainly for dialup lines. It mns a command which 
ignores the hang up of the telephone. For further details see the nohup manual 
page. 

The nice command runs a command in low or high priority. For further details 
see the nice manual page. 

The kill command terminates specified processes or jobs. For further details 
see Doing More with SunOS: Beginner’s Guide and the kill manual page. 

The at command schedules execution of a command at an arbitrary time. For 
further details see Doing More with SunOS: Beginner’s Guide, at, batch, and 
crontab manual pages. 

The tee command splits the output from commands into one or more files. For 
further details see Doing More with SunOS: Beginner’s Guide and the tee 
manual page. 
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User Access and Commands 


User accounts and optional passwords are used to gain access to the SunOS 
operating system. The login and passwd programs are used to log on to your 
local workstation. Once logged on to a workstation you can remotely log into 
other systems using the rlogin program. You also can access geographically 
remote hosts with the tip program described in chapter 10, Communication 
Facilities. 

6.1. Gaining Access to the The login command is used to gain initial access to the system. Features of the 

System login command include: 

□ ability to sign on as a new user; 

□ ability to verify password and to establish user’s individual and group (pro¬ 
ject) identity; 

□ define terminal characteristics; 
o establish a working directory; 

□ announce the presence of mail; 

□ publish a message of the day; 

□ execute user-specified startup files; and, 

o execute command interpreter or other initial program. 

For more information see Using the Network: Beginner’s Guide and the login 
manual page. 

6.2. Changing your The passwd command establishes your initial password or changes an existing 

Password password. Passwords can be changed and are encrypted for security. For further 

details see Getting Started with SunOS: Beginner’s Guide and the passwd 
manual page. 

6.3. Logging Out The logout command logs you out of the system. An optional . logout file 

can be created containing good bye messages, jokes, etc. For further details see 
Getting Started with SunOS: Beginner’s Guide and the logout manual page. 
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6.4. Useful Commands The following is a brief description of some useful commands. A pointer for 

where to find more information for each command also is included. Files, direc¬ 
tories, and the commands used to manipulate them are described in chapter 7, 
Working with Files. 

Displaying Date and Time The date command displays the current date and time. As superuser you can 

use date to set the system date and time. For further details see Getting Started 
with SunOS: Beginner’s Guide and the date manual page. 

The who command displays a fist of presently logged on users, ports and login 
times. The w command displays a fist of who is logged in and which command 
they are running. For further details see Doing More with SunOS: Beginner’s 
Guide and the who and w manual pages. 

Displaying What is Going on The ps command displays information for active processes. The display can 

contain the following process information: 

□ a list your own or everybody’s processes; and, 

□ can provide optional process status information such as, state and scheduling 
information, priority, attached terminal, what a process is waiting for, and 
size. 

For further details see Doing More with SunOS: Beginner’s Guide and the ps 
manual page. 

Logging into Another The rlogin command logs you onto another machine in the local network. For 

Machine further details see Using the Network: Beginner’s Guide and the rlogin 

manual page. 

Running Commands on Other The r sh command executes a shell on a remote host in the local network. For 
Machines further details see Using the Network: Beginner’s Guide and the rsh manual 

page. 

Reminder Service The calendar command provides an automatic reminder service of events for 

today and tomorrow. For further details see Getting Started with SunOS: 
Beginner’s Guide and the calendar manual page. 

Calculator — be The be command is a C-like interactive interface to the dc desk calculator. Its 

features include: 

□ all the capabilities of dc with a high-level syntax; 

□ arrays and recursive functions; 

□ when called returns immediate evaluation of expressions and evaluation of 
functions; 

□ arbitrary precision elementary functions exp, sin, cos, atan; and, 

□ go-to-less programming. 
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For further details see Getting Started with SunOS: Beginner’s Guide and the be 
and dc manual pages. 





Asun 

XT microsystems 


Revision A, of 9 May 1988 










7 


Working with Files 


The SunOS operating system us&s files to organize and to store information. The 
system file organization is called a hierarchical file system, and it is one of the 
SunOS operating system’s major strengths. 

7.1. What is a File? A file is a collection of data such as words, characters, numbers, etc., that is 

stored together. Files have several attributes — the major and most important 
attribute being the name of the file. Other attributes include the access permis¬ 
sions, size, date, and time the file was created, and the date and time the file was 
last changed. 

7.2. What is a Directory? Files reside in a directory. A directory is a special kind of file that contains other 

files and directories. Since a directory can contain other directories, the hierar¬ 
chy, in principle, can extend to unlimited depth. 

The SunOS operating system treats just about every object in the system as a file. 
For example, the physical memory of the computer can be accessed and manipu¬ 
lated like a file. 

When new accounts are created an initial working directory also is created. This 
initial directory is called a home directory and you are positioned in this home 
directory when you log on to the system. 

Changing directories positions you at a specified place in the file system hierar¬ 
chy. This specified place is called the current directory or the working directory. 

For more information on files and directories see Getting Started with SunOS: 
Beginner’s Guide. 

13. Access Permissions When files or directories are created, access permissions are also created as part 

of the file’s attributes. Access pennissions establish who can access the directory 
or file, and what operations they can perform. The access permissions are called 
die mode of the file. Three types of users can access a directory or file: 

□ the owner — the person who originally created the directory or file; 

□ the group — the group of users to which the owner belongs; and, 

□ the public — any one other than the owner and the members of the owner’s 
group. 
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For each type of user there are three kinds of access to a directory or file: 

read view the contents of the file or view the inside the directory; 

write change the contents of the file or create other directories or files 
inside a directory; and, 

execute type the name of the file as a command or perform certain operations 
to traverse through the directory. 

For more information see Doing More with SunOS: Beginner's Guide. 


7.4, Manipulating Files and 
Directories 


There are two types of utilities that manipulate files and directories: 

□ the first type creates, removes, and renames files and directories; and, 

□ the second type copies and manipulates the contents of files and directories. 

In general, the first type of programs manipulate the attributes of files and direc¬ 
tories, while the second type of programs manipulates the data stored in the files. 


7.5. Managing Files and There are numerous utilities for managing files and directories. Simple files are 

Directories created with such utilities as cat (described later), or with one of the system’s 

text editors described in chapter 9, Editing Text Files. Directories are created 
with a special command, described below. 

The figure, below shows commands used to manage files and directories. Each 
of these commands is described below the figure, and a reference is included for 
further information. 
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Figure 7-1 Commands to Manage Files and Directories 



Displaying a List of File The Is command displays an alphabetically, sorted list of file and directory 

Names names. The Is command can display filenames in many alternate ways, such as: 

□ displaying filenames in reverse alphabetical order; 

□ displaying filenames by time of last access; 

□ mark the display showing directories distinct from files and mark executable 
(program) files; 

o display optional information — size, owner, group, date last modified, date 
last accessed, permissions, and i-node number. 

For further details see Getting Started with SunOS: Beginner’s Guide and the Is 
manual page. 

Changing the Working The cd command changes the working directory to a specified place in the direc- 

Directory tory hierarchy. A cd command without any specified directory name, always 

returns to the home directory. For further details see Doing More with SunOS: 
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Beginner’s Guide and the cd manual page. 

Displaying Current Directory The pwd command displays the name of the current working directory. For 
Name further details see Getting Started with SunOS: Beginner’s Guide and the pwd 

manual page. 

Creating a New Directory The mkdir command creates a new directory. For further details see Getting 

Started with SunOS: Beginner’s Guide and the mkdir manual page. 


Removing a Directory The rmdir removes a directory from the file system. The directory must be 

empty (contain no files or other directories) before it can be removed. For further 
details see Doing More with SunOS: Beginner’s Guide and the rmdir and rm 
manual pages. 


Changing Access Permissions The chmod command changes the the access permissions (or mode) for one or 

more files. Only the owner of the file, or the superuser, can change a file’s access 
permissions. For further details see Doing More with SunOS: Beginner’s Guide 
and the chmod manual page. 


Changing Group Ownership Groups can be created on the system for users who are associated with a project. 

When files are created, they are associated not only with an owner, but also with 
a group. The chgrp command changes the group a file belongs to. For further 
details see Doing More with SunOS: Beginner’s Guide and the chgrp manual 
page. 

Renaming or Moving Files The mv command moves a file or files from one place to another in the directory 

hierarchy. The mv command actually renames files or directories. When a file is 
moved from one place to another, the destination name can be different from the 
source name. Moving a file with a different source and a different destination 
names within the same directory effectively renames the file without physically 
moving it. 

The mv command also moves entire directory hierarchies from place to place in 
the tile system. For further details see Getting Started with SunOS: Beginner’s 
Guide and the mv manual page. 

Creating File Links The In command creates a link or an alias to an existing file. There are two 

types of links: 

□ hard links can be created only within a file system and make a real physical 
link in the structure; and, 

□ symbolic links are similar to a macro or string substitution and can span file 
systems. The difference between the two types of links becomes apparent 
when removing files as described in the rm command, below. For further 
details see Doing More with SunOS: Beginner’s Guide and the In and rm 
manual pages. 
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Removing Files and 
Directories 


Finding Specified Files and 
Directories 


Displaying Statistics for the 
File System 


7.6, File Manipulation 
Facilities 


ITie rm command removes files and, when used with special options, also 
removes entire directory hierarchies. The rm command can do the following: 

□ remove only the name of the file if any other names are linked to the file. 
This is an important effect of symbolic links as discussed in the In com¬ 
mand. When removing symbolically linked files you can end up with a sym¬ 
bolic link that does not point to anything. 

□ interactively delete files; an option of the rm command steps through a 
directory asking if you want to delete a file. 

□ used with the special recursive option, -r deletes entire directory hierar¬ 
chies. 

For further details see Getting Started with SunOS: Beginner’s Guide, Doing 
More with SunOS: Beginner’s Guide, and the rm, rmdir , and In manual pages. 

The find command prowls the directory hierarchy locating every file that meets 
a specified criteria. Any directory can be the root or starting place for the search. 
The find command can do specified operating system commands on each file 
that matches the specified criteria. The criteria includes: 

□ filename matches a given pattern; 

□ creation date in given range; 

□ date of last use in given range; 

n given pennissions; 

□ given owner; 

□ given special file characteristics; and, 

□ Boolean combinations of above. 

For further details see Doing More with SunOS: Beginner’s Guide and the find 
manual page. 

The df command displays the amount of free space on file systems, and the du 
command displays a summary of total space occupied by aU. files in a hierarchy. 
For further details see Doing More with SunOS: Beginner’s Guide and the df 
and du manual pages. 

Commands described so far are used for creating files and directories and mani¬ 
pulating their attributes. The figure below shows commands used to manipulate 
the contents of files and directories. Each of these commands is described below 
the figure, and a reference is included for further information. 
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Figure 7-2 Commands to Manipulate the Contents of Files and Directories 



Determining the Type of a File The file command determines what kind of information is in a file. By con¬ 
sulting the file system index and by reading the file itself, the file command 
determines, among many others, if a file is one of the following: 

□ a plain text file — ASCII; 

□ a repository of files — directory; 

□ input for one of the text formatting packages troff, nroff, or eqn input text; 

□ source code for the C programming language — C program text. The file 
command also can determine if it is FORTRAN source code; and, 

□ an executable file. 

For further details see Doing More with SunOS: Beginner’s Guide and the file 
manual page. 

Combining Files The cat command joins together files from end to end (concatenates) and 

displays the result to standard output (the screen). The cat command has a 
variety of uses, including: 

□ inserting data into a pipeline; 
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□ optionally displaying non-printing characters; 

□ optional number lines; and, 

□ buffer output that appears in pieces. 

The cat command works on any file regardless of its contents. For further 
details see Getting Started with SunOS: Beginner’s Guide and the cat manual 
page. 

Copying Files and Directories The cp command copies files (and optionally whole directory hierarchies) from 

one place to another. The cp command can: 

o copy a set of files to a directory; 

□ copy any file regardless of its contents; and, 

□ used with the -r (recursive) option copy entire directory hierarchies. 

For further details see Getting Started with SunOS: Beginner’s Guide and the cp 
manual page. 

Remote Copying The remote copy command, rep, copies files and directories to and from other 

machines on the local network. For further details see Using the Network: 
Beginner’s Guide and the rep manual page. 

Browsing through a File The more command scrolls forward through the contents of a file. Features of 

the more command include: 

□ account for the size characteristics of a terminal and displays a page of a file 
at a time; 

□ option to scroll forward a page or a line at a time by typing keys; and, 

□ option to skip forward to selected patterns in the file. 

For further details see Getting Started with SunOS: Beginner’s Guide, Doing 
More with SunOS: Beginner’s Guide and the more manual page. 

Doing Binary Compares The emp command performs binary comparison on a pair of files and reports the 

first place where it finds a difference in the data. For further details see the emp 
manual page. 


Displaying Top or Bottom of 
File 


The head command displays the top ten lines of a file, and the tail command 
displays the last ten lines of a file. For further details see Doing More with 
SunOS: Beginner’s Guide and the head and tail manual pages. 


Splitting a File The split command divides a file into a specified number of pieces. This com¬ 

mand is useful for dealing with some older utilities that have limitations on the 
number of lines they can digest at one time. For further details see the split 
manual page. 
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Converting Data Formats The dd command translates physical ffle formats to exchange data with other 

operating systems. For further details see the dd manual page. 

Doing a File Checksum The sum command sums the words of a file, providing a convenient checksum. 

For further details see the sum manual page. 

7.7, Summary of File and The following table provides an alphabetical list of the file and directory com- 
Directory Commands mands presented in this chapter. 

Table 7-1 Summary of File and Directory Commands 


Program 

Name 

Function 

cat 

join files 

cd 

change directory 

chgrp 

change group 

chmod 

change access permissions 

cmp 

do a binary compare of files 

cp 

copy files 

dd 

convert file formats 

df 

display free space 

du 

display disk usage 

file 

find file type 

find 

find files 

head 

display top of file 

In 

create links to file 

Is 

display file and directory names 

mkdir 

create directory 

more 

page through file 

mv 

move or rename file 

pwd 

display name of current working directory 

rep 

remote copy files 

rm 

remove file 

rmdir 

remove directory 

split 

split file 

sum 

checksum file 

tail 

display end of file 
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Editing Text Files. 

8.1. Printing Text Files. 

8.2. Interactive and Non-interactive Text Editors .... 

8.3. Information Processing and Text Manipulation 

8.4. Summary of Text Processing Utilities. 
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Editing Text Files 


Since files are used to store and to organize data, it is reasonable that there are 
numerous utilities to manipulate a file’s contents. The diagram below summar¬ 
izes common text editing utilities. The sections which follow describe the func¬ 
tions and abilities of these text editing utilities in more detail and provide refer¬ 
ences for further information. 


Figure 8-1 Commonly Used Text Editing Utilities 




blah blah blah blah blah blah 
rhubarb rhubarb rhubarb... 
blah blah blah blah blah blah 
rhubarb rhubarb rhubarb .., 
blah blah blah blah blah blah 
rhubarb rhubarb rhubarb ... 
blah blah blah blah blah blah 
rhubarb rhubarb rhubarb... 
blah blah blah blah blah blah 
rhubarb rhubarb rhubarb ... 
blah blah blah blah blah blah 
rhubarb rhubarb rhubarb... 
blah blah blah blah blah blah 
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8.1. Printing Text Files While the Ipr command sends files to the printer, it does no transformations on 

the text whatsoever and places no interpretations on the data in the text file. No 
‘carriage-control’ characters are embedded as in other systems. The pr com¬ 
mand (described below) can be used to prepare a file for printing with Ipr. 


Preparing Files for Printing The pr command prepares files for printing with a printer program — usually 

Ipr. pr is a simple but flexible utility, and can do the following: • 

a place a title, date, and page number on every page; 

o arrange text into multiple columns; 

□ merge several files into multiple columns in parallel; and, 

□ specify the number of columns on a page and the number of lines on a page. 
For further details see Editing Text Files and the pr manual page. 

Printing Files Offline The Ipr utility is the line printer control program for spooling arbitrary files to 

printers for off-line printing. One option to Ipr can use the pr program 
described above to paginate text before it is printed. 

In addition to printing files, the line printer spooler system has facilities to exam¬ 
ine the print queue (Ipq) and to remove jobs from the print queue (Iprm). For 
further details see Editing Text Files and the Ipr, Ipq, and Iprm manual pages. 


8.2. Interactive and Non¬ 
interactive Text 
Editors 


Editing Text Files 


Visual Editor 


Text editors and other text manipulation software comprise a large part of the 
facilities offered in the SunOS operating system. Most text editing utilities rely 
on regular expressions to specify text patterns for searching. The major capabili¬ 
ties of searching using regular expressions include: 

o match single characters or strings of characters; 

□ match any arbitrary character; 

□ match classes of characters; such as, match any lower-case letter, or match 
upper-case letters in the range I thru M. 

□ match closures — zero to many of the previously mentioned patterns; 

□ match specified patterns only at the start or end of a line — such patterns are 
said to be anchored; and, 

□ match alternative patterns — known as alternation. Only some of the pat¬ 
tern scanning utilities, most notably egrep and awk, handle alternation. 

In addition to the textedit mouse-driven editor described in chapter 4, Sun- 
View —A Window Environment there is a family of three editors; one a screen 
editor, and the other two, line editors that are the principal tools for creating and 
editing text. 

The vi editor is a screen-oriented display editor. It provides ‘what you see is 
what you get’ editing for either line-oriented or full screen terminals, vi is a 
powerful and flexible editor with regular expression searching and user-specific 
settings. 
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For further details see Getting Started with SunOS: Beginner’s Guide, Editing 
Text Files, and the vi manual page. 

Line Oriented Editor The ex editor is the line-oriented parent of vi, based on the original ed editor. 

The ex editor subsumes all functions of the ed editor. For further details see 
Editing Text Files and the ex manual page. 

Original Line Oriented Editor The ed editor was the original line-editor for the UNIX system. Although it is 

superseded by more powerful display editom such as vi, ed still has its place 
among some utilities which generate ed commands for automatic editing. An 
interactive context editor, ed provides random access to all lines of a file. Its 
features include: 

□ find lines by number or pattern; 

□ add, delete, change, copy, move or join lines; 

□ permute or split contents of a line; 

□ replace one or all instances of a pattern within a line; 

□ combine or split files; 

o escape to the shell command language during editing; 

□ do any of above operations on every pattern-selected line in a given range; 
and 

□ optional encryption for extra security. 

For further details see Editing Text Files and the ed manual page. 

Batch or Stream Editing The sed command is a non-interactive stream text editor. It is a version of the 

ed editor, used for processing large files. Features of sed include: 

□ performs a sequence of editing operations on each line of an input stream of 
unbounded length; 

□ lines are selected by address or range of addresses; and, 

□ has control flow and conditional testing, multiple output streams, and multi- 
line capability. 

For further details see Editing Text Files and the sed manual page. 

Information processing includes utilities intended originally for statistical text 
processing, such as; 

□ counting lines, words, and characters in a file; 

□ rearching for specific patterns in a file; 

□ transliterating characters; and, 

□ sorting the contents of a file. 

Utilities used for information processing are described below. 


8.3. Information 

Processing and Text 
Manipulation 
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Counting Things in Files 


Translating Characters 


Scanning for Text Patterns 


Three flavors of a pattern 
matching program 


Sorting Files 


The wc command counts the lines, words (blank-separated strings) and charac¬ 
ters in a file. For ftirther details see Editing Text Files and the wc manual page. 

The tr command changes one character into another by: 

□ translating one-to-one characters according to an arbitrary code; 

o coalescing selected repeated characters; and. 

□ deleting selected characters. 

For further details see Editing Text Files and the tr manual page. 


The gr ep command is one command in a family of programs that search for pat¬ 
terns in a file. The name grep stands for ‘Global Regular Expression Print’ and 
is derived from typing the ed line editor global command: 


r 

- 

g/i?F/p 


(_ 

_/ 


This command Ime prints every line that contains the specified regular expres¬ 
sion {RE). Features of grep include: 

□ display aU lines in a file that satisfy a regular expression; 

□ display all lines that fail to match; 

□ display count of matches; and, 

□ display first match in each file. 

There are actually three programs in the grep family: 

grep is the original pattern scanning program, grep handles regular expres¬ 
sions containing any character, character classes, anchored matches, 
and closures. 

egrep is the extended version of grep. egrep handles all the regular 
expressions that grep can handle, plus alternation — look for an 
occurrence of pattern A or B or C, and so on. 

f grep searches for fixed strings. The only metacharacters supported are those 
that anchor the pattern to die beginning or end of a line. The fixed 
strings may be in a file. 

For further details see Getting Started with SunOS: Beginner’s Guide, Doing 
More with SunOS: Beginner’s Guide, Editing Text Files, and the grep, egrep, 
and f grep, manual pages. 

The sort command is the main general-purpose sort utility, sort merges or 
sorts ASCII files line-by-line. This program is radically different from the tradi¬ 
tional sort-merge utilities found on other computer systems because sort does 
not need input in fixed width fields starting in specific columns. Instead, sort 
breaks lines of a file into fields separated by white space (you can specify the 
field delimiter). Feamres of sort include: 
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Removing Successive 
Duplicate Lines 


Sorting Topologically 


Scanning Patterns and 
Processing Text 


Displaying Differences 
Between Files 


o no limit on input size; 

□ sort up or down; 

□ sort lexicographically or on numeric key; 

□ sort by multiple keys located by delimiters or by character position; 

□ sort upper case together with lower into dictionary order; and, 

□ optionally suppress duplicate data. 

The uniq command collapses successive duplicate lines in a file into one line. 
The sort command also performs this function, but it is useful, at times, to have 
the facility available as a separate function, uniq reports on lines that were ori¬ 
ginally unique, duplicated, or both, and displays a redundancy count for each 
line. 

The t sort command is a topological sort that converts a partial order into a 
total order. For further details see Editing Text Files and the sort, uniq, and 
tsort manual pages. 

The awk command is a pattern scanning and processing language. With this 
language it is easy to specify many data transformations and selection operations, 
awk can be viewed as a ‘programmable report generator’. It contains all the 
capabilities of the grep family of pattern scanners, but can manipulate data from 
text files and also can perform computations. 

The awk programming language is named after its authors Aho, Weinberger, and 
Kemighan. Features of awk include: 

□ Searches input file for specified patterns and does actions on each line of 
input that satisfies the selection criteria. Patterns include regular expressions 
in the style of grep and egrep, arithmetic and lexicographic conditions, 
and Boolean combinations and ranges of these. 

□ Treats data as string or numeric as appropriate. 

□ Breaks input into records and fields. Fields are referenced as variables, and 
records can span multiple lines. 

o Expression and string manipulation works on variables and arrays (with 
non-numeric subscripts). There is a full set of arithmetic operators and con¬ 
trol flow in the style of the C programming language. 

□ Output is foimatted as desired, and is directed to multiple output streams. 

For further details see Editing Text Files and the awk manual page. 

The dif f command compares two files and reports differences, dif f is so 
named because it is a differential file comparator — it does more than just report 
that there is a mismatch. Features of dif f include: 

□ reports line changes, additions, and deletions necessary to bring two files 
into agreement; and. 
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□ produces an editor script to convert one file into another — the generated 
editor script is intended for the ed text editor described above. 

A variant of dif f called dif f 3 compares two new versions of a file against 
one old one. For further details see Editing Text Files and the dif f and dif f 3 
manual pages. 

Finding Commonality The comm command identifies common lines in two sorted files. The output is 

Between Files displayed in three columns which show lines present in first file only, present in 

both, and/or present only in second. For further details see Editing Text Files and 
the comm manual page. 

Checking Spelling The spell command finds spelling errors by comparing each word in a docu¬ 

ment against a dictionary list that includes proper names. Features of spell 
include: 

□ handles common prefixes and suffixes; and 

□ collects words to help tailor local spelling lists. 

For further details see Editing Text Files and the spell manual page. 


Searching for Words in a The look command searches for words in a sorted file (usually a dictionary) that 

Sorted File begin with a specified prefix. For fiirther details see Editing Text Files and the 

look manual page. 


Encrypting and Decrypting The crypt commands encrypts and decrypts files for greater security. For 
Files further details see Editing Text Files and the crypt manual page. 


Joining Records in File 


The join commands combines two files by joining records with identical keys. 
For further details see Editing Text Files and the join manual page. 
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8.4. Summary of Text The following table is an alphabetical list of the text utilities described in this 

Processing Utilities chapter. 

Table 8-1 Summary of Editing and Text Processing Programs 


Program 

Name 

Function 

awk 

scan patterns and process text 

comm 

find commonality between files 

crypt 

encrypt 

diff 

display differences between files 

ed 

(very primitive) line editor for text files 

egrep 

scan for text patterns 

ex 

line oriented editor for text files 

fgrep 

scan for text patterns 

grep 

scan for text patterns 

join 

join records in file 

look 

search for words in a sorted file 

Ipq 

display print queue 

Ipr 

print files offline 

Iprm 

remove jobs from print queue 

pr 

prepare files for printing 

sed 

batch or stream editing 

sort 

sort files 

spell 

check spelling 

tr 

translate characters 

uniq 

remove adjacent duplicate lines from sorted file 

vi 

visual editor for text files 

wc 

count characters, words, and lines in files 
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Formatting Documents 


Numerous tools for producing technical documents are available with the SunOS 
operating system. The text edit mouse-based system of SunView is a basic 
text editing utility. Information on textedit is described in chapter 4, Sun- 
view —A Window Environment. The major tool for producing complex docu¬ 
ments istroff — a text formatter originally created for a second-generation 
phototypesetter called a C/A/T. 

Since trof f was created for older typesetting technology, it requires detailed 
instmctions for laying out a document. Not only must users be familiar with the 
details of each trof f request, but they must also be knowledgeable of typogra¬ 
phy terms and concepts. Numerous utilities and tools are now available to ease 
the use of trof f. 

Macro packages are perhaps the most important tool to help users in generating 
documents. A macro package is a type of style guide — users type in ‘high- 
level’ commands reminiscent of the structure of the document instead of hun¬ 
dreds of detailed trof f requests. In addition to macro packages, various 
preprocessors produce mathematical equations, tables, and line drawings. The 
picture below conveys some of the extensive tools available for producing docu¬ 
ments. 
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Figure 9-1 Document Formatting Model with Macro Package 
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9.1. Formatting Documents The major document formatting programs available are trof f and nrof f. 

Although there are ‘What You See Is What You Get’ (WYSIWYG) document 
preparation packages available for the Sun Workstation, trof f and nr off still 
are valuable for very difficult formatting applications applications where 
WYSIWYG systems don’t, as yet, fit the bill. 

Although trof f originally was written for a specific second-generation photo¬ 
typesetter it can be used with appropriate conversion utilities to drive other types 
of devices. Both trof f and nrof f use the same input language and are capa¬ 
ble of elaborate formatting feats when programmed appropriately. Features of 
these utilities are: 

□ completely definable page format keyed to dynamically planted ‘interrupts’ 
at specified lines; 

□ maintain several separately definable typesetting environments (for example, 
one for body text, one for footnotes, and one for unusually elaborate head¬ 
ings); 

□ arbitrary number of output pools can be combined at will; 

o macros with substitutable arguments, and ability to use mid-line macros; 

□ computation and printing of numerical quantities; 

□ conditional execution of macros; 

□ tabular layout facility; 

□ positions expressible in inches, centimeters, ems, points, machine units or 
arithmetic combinations thereof; 

□ access to character-width computation for unusually difficult layout prob¬ 
lems; 

□ overstrikes, built-up brackets, horizontal and vertical line drawing; 

□ dynamic relative or absolute positioning and size selection, globally or at the 
character level; 

□ can exploit the characteristics of the terminal being used, for approximating 
special characters, reverse motions, proportional spacing, etc.; 

o typesetter has a vocabulary of several 102-character fonts (4 simultaneously) 
in 15 sizes; and, 

□ provides terminal output to view sample of final output; 

For further details see Formatting Documents and Using nrof f and trof f and 
the trof f and nrof f manual pages. 

9.2. Macro Packages Amacrofacility is available to use with trof f. Macros are a sequence of 

frequently-used trof f requests collected together into named chunks. These 
named chunks (macros) are called by name to achieve standardized formatting 
actions. 


Asun 

NT microsystems 


Revision A, of 9 May 1988 



76 Sun System Introduction 


-ms Macro Package 


-man Macro Package 


9.3. Preprocessors 


Mathematical Typography 
Example of eqn 


A macro package can be considered the style sheet for a document. The user 
types in ‘high-level’ instmctions to indicate the start of text constmcts such as 
paragraphs, tables, and such, and the macro packages translates these instructions 
into the detailed trof f requests needed to achieve the desired layout. 

Sun supports the -ms macro package — a standardized manuscript layout pack¬ 
age of requests for use with nrof f and trof f. Features of the -ms macro 
package include: 

□ standard indented paragraphs, block-paragraphs, itemized paragraphs, 
quoted paragraphs; 

□ various forms of indented and non-indented displays, ‘keep’ displays, float¬ 
ing displays, tables, and displayed and numbered equations; 

□ automatically numbered headings; 

□ foomotes — automatically numbered or with user-defined symbols; 

□ multiple-column layout; 

□ standardized placing of page numbers; 

□ standardized mnning headers and footers — users can specify in detail the 
form of odd and even headers and footers; and, 

□ draft dates. 

For further details see Formatting Documents. 

The -man macro package is the second major macro package designed for for¬ 
matting the on-line manual pages. The -man macro package is less complex, 
but based upon the -ms macro package. These macros are primarily used to for¬ 
mat the ‘man pages’. For further details see Formatting Documents. 

The major preprocessors for trof f are tbl, used for describing tabular layouts, 
and eqn used for describing mathematical equations. Both tabular layout and 
mathematics are known as ‘penalty copy’ in the typesetting trade because of the 
need for a large number of finely detailed formatting requests. 

The mathematical typesetting preprocessor, eqn, translates easily readable for¬ 
mulas, either in-line or displayed, into detailed troffornroff instructions. 


Equation formulas are written as if you were saying them aloud to someone. For 
example: 


r 

sigma sup 2 ~=~ 1 over N sum from i=l to N i 

( X sub i - 

- X bar ) 

sup 2 

'N 

k 




_2 
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Laying Out Tables 


Example of a Table 


produces: 

•''' i=l 

\ _ / 


There is a version of eqn for nrof f named neqn. The neqn preprocessor 
accepts the same input language as eqn and prepares formulas for workstation or 
terminal display, neqn has the same facilities as eqn within the graphical capa¬ 
bility of the workstation. 

Features of eqn include: 

□ automatic calculation of size changes for subscripts, sub-subscripts, and for 
equations such as ; 

□ full vocabulary of Greek letters and special symbols, such as ‘gamma’ for 7 , 
‘GAMMA’ forF, ‘integral’ for J, and so on; 

□ automatic calculation of large bracket sizes; 

a vertical ‘piling’ for matrices, conditional alternatives, etc.; 
o integrals, sums, etc., with arbitrarily complex limits; 

□ diacriticals: dots, double dots, hats, bars, etc.; and, 

□ easily learned by nonprogrammers and mathematical typists. 

For further details see Formatting Documents and the eqn manual page. 

The tbl preprocessor translates simple descriptions of table layouts and contents 
into detailed typesetting instructions for nrof f and trof f. Features of tbl 
include: 

□ computes column widths; 

□ handles left- and right-justified columns, centered columns and decimal- 
point alignment; 

□ places column titles; 

□ table entries can be text, which is adjusted to fit column width; and, 

□ can box all or parts of table. 

Here is a small example of the input for a table: 
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Bibliographic References The refer preprocessor is a bibliography system to support citations in docu¬ 

ments. The refer system comprises a set of facilities for data entry, indexing, 
retrieval, sorting of a bibliographic database. 

Supporting utilities make refer easier to use. They include: 

□ addbib which creates and extends the bibliographic database; 

□ sortbib which sorts the bibliographic database by author, date, or other 
criteria; and, 

□ rof f bib which formats the entire bibliographic database as a bibliography 
or annotated bibliography. 

For further details see Formatting Documents and the addbib, sortbib, 
rof f bib, indxbib, and lookbib manual pages. 

9.4. Other Document In addition to the major document formatting tools described above, there are a 

F or matting T ools number of other minor supporting tools. 

Checking Spelling Errors The spell utility checks the spelling of a document against an on-line diction¬ 

ary. For further details see Formatting Documents and the spell manual page. 

The col utility converts files with reverse line feeds into canonical form for 
one-pass printing, col is used mainly with nrof f for printers that can not do 
reverse paper motions. For further details see Formatting Documents and the 
col manual page. 

Stripping tr off Constructs The deroff utility removes t rof f requests from a source file. The spelling 

checker facility, among others, uses deroff to remove all trof f requests 
which would otherwise be displayed as misspelled words. For further details see 
Formatting Documents and the deroff manual page. 

Checking Syntax The checknr program checks a document for possible mismatched opening 

and closing delimiters and unknown trof f requests. The complexity of trof f 
requests and macro calls can sometimes lead to strange effects such as entire 
parts of a document disappearing into a black hole. Such problems are often 
caused by starting a display and forgeting to end it. 

The checkeq program checks a document for correctly specified equations. 

For further details see Formatting Documents and the checknr and checkeq 
manual pages. 

Generating a Permuted Index The ptx command generates a permuted, or keyword-in-context, index from text 

files. For further details see Formatting Documents and the ptx manual page. 
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9.5. Summary of Document Below is an alphabetical list of the document formatting commands described in 
Formatting Utilities this chapter. 

T able 9-1 Summary of Document Formatting Programs 


Program 

Name 

Function 

checkeq 

check that specified equations are correct 

checknr 

check n r o f f and t r o f f constructs 

col 

filter out reverse paper motions 

deroff 

remove nrof f and trof f constructs 

eqn 

language for specifying mathematical equations 

-man 

macro package to format the on-line manual pages 

-ms 

popular macro package for producing documents 

nrof f 

document formatter for typewriter-like devices 

ptx 

generate permuted (keyword in context) index 

refer 

bibliographic database processor 

spell 

check spelling 

tbl 

language for describing columnar layouts 

trof f 

document formatter for typesetters or laser writers 
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Communication Facilities 


Electronic mail and facilities for transferring files to and from remote machines 
are available on the SunOS operating system for; 

□ communicating between users on a single time-sharing machine; 

□ communicating between users on different machines in the local network; 

□ communicating between users on different host machines in geographically 
distributed locations; and, 

□ facilities for accessing remote machines. 

The first two categories are considered roughly equivalent since the local net¬ 
work facilities, in many cases, makes such access transparent. 

10.1. Local There are numerous ways to communicate with other users on the same host or 

Communications on other host machines on the local network. Local communications utilities are 

Facilities described below. 


Talking Directly with Another The talk command establishes direct workstation or terminal communication 
User with other users on a different machine on the local network. The me sg com¬ 

mand inhibits receipt of messages from the talk command. For further details 
see Mail and Messages: Beginner’s Guide and the talk, and mesg, manual 
pages. 

Sending and Receiving Mail The mail command is an electronic mail system that sends messages to users on 

the same machine, or to users on other machines on the local network, and to 
remote machines (using the capabilities of uucp described below). Features of 

the mail command, include: 

□ sending messages to one or more users; 

□ reading and disposing of individual messages; 

□ announcing the presence of mail through the login program, and option¬ 
ally by the csh program; 

□ saving messages in files or forwarding them; and, 

o supporting items such as ‘Subject:’ and ‘Cc:’ fields. 
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10.2. Remote 

Communication 

Facilities 

Directly Accessing Remote 
Machines 


Transferring Data Between 
UNIX Systems 


Mail Tool is a window interface for the mail program. For further details see 
Mail and Messages: Beginner’s Guide, SunView 1 Beginner’s Guide, and the 
mail and mailtool manual pages. 

There are ways to access remote machines (machines outside the local network) 
for transferring files. Facilities for remote communication are described below. 

The tip command establishes a full-duplex connection for logging onto remote 
computers. Features of tip include: 

□ a transparent interface to the remote machine; 

□ transmitting files; and, 

□ taking remote input from local file or putting remote output into local file. 

For further details see Using the Network: Beginner’s Guide and the tip manual 
page. 

The UUCP command allows spooled file transfers between machines. Features of 
UUCP include: 

□ automatic queuing until line is available and remote machine is responding; 
and, 

□ copying between remote machines. 

In general, the uucp facilities are not used directly by users but service programs 
such as mail. For further details see System and Network Administration and 
the UUCP manual page. 
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SunOS — Internal Features 


The SunOS operating system is based on the converged Berkeley 4.2BSD and 
AT&T System V. It is enhanced to provide high-performance facilities for all 
software packages and to maximize system throughput for workstations on 
heterogeneous networks. In this chapter the major features of the SunOS operat¬ 
ing system are presented and reference pointers are included for more informa¬ 
tion. 

At the bottom layer of the operating system is the kernel — a collection of sys¬ 
tem services that manage the resources of the system on behalf of application 
programs. Applications can either access the kernel’s primitive functions 
directly, or make use of library functions that in turn use the kernel’s primitive 
functions. The SunOS kernel supports a virtual memory management scheme 
that promotes system resource sharing and portability across diverse hardware 
platforms. 

The illustration below shows the kernel primitive functions divided into func¬ 
tional groups. For more information on kernel functions see System Services 
Overview and SunOS Reference Manual. 
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Figure 11-1 Kernel Primitive Functions 
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As previously stated, most applications use one or more standard library pack¬ 
ages that in turn call the kernel. The main groups of library packages are illus¬ 
trated in the figure below. 

Figure 11-2 Standard Library Packages 
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To find out more about these libraries consult the following manuals: 


Library 

Described in Manuai(s) 

C Library 

SunOS Reference Manual 

Standard I/O Library 

Programming Utilities and Libraries 

SunOS Reference Manual 

Network Library 

Network Programming 

SunOS Reference Manual 

Remote Procedure Call 
Library (RPC) 

Network Programming 

SunOS Reference Manual 

Math Library 

SunOS Reference Manual 

lex Library 

Programming Utilities and Libraries 

CGI Libraries 

SunCGI Reference Manual 

SunCore Libraries 

SunCore Reference Manual 

Suntools Library 

SunView 1 System Programmer’s Guide 

Sunwindows Library 

SunView 1 System Programmer’s Guide 

Pixrect Library 

Pixrect Reference Manual 

Database Library 

SunOS Reference Manual 

Curses Library 

SunOS Reference Manual 

Terminal Driver 

Libraries 

SunOS Reference Manual 

Plot Library 

SunOS Reference Manual 

Lightweight Processes 
Library 

Programming Utilities and Libraries 

System Services Overview 


11.1. Major Features of Other than the kernel primitives and standard libraries, major features of the 

SunOS SunOS operating system include: 

□ shared libraries; 

□ lightweight process library; 

□ device-independent I/O and redirection; 

□ virtual memory; 

□ job control facilities; and, 

□ standards. 

Each of these features is described below and reference pointers are included for 
more information. 
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Shared Libraries and The shared libraries system enables processes running different programs to 

Dynamic Linking share libraries common to each other. The shared libraries system is simple and 

flexible and improves overall system performance. Features of shared libraries 
include: 

o minimizes kernel support; 

□ does not require that shared libraries be used; 

□ designed to minimize burden placed on users of exiting code; and 

□ improves the development environment. 

Dynamic linking allows you to develop your own shared libraries. For more 
information on shared libraries see Programming Utilities and Libraries. 

Lightweight Process Library The lightweight process library provides primitives for manipulating threads of 

control, as well as, for managing events such as interrupts and traps. Lightweight 
processes are good for implementing service processes which must maintain state 
for multiple connections, and for programs which manage asynchrony. At 
present, there is no kernel support for lightweight processes, so concurrent sys¬ 
tem calls must be implemented by forked UNIX processes. 

Features of lightweight processes include: 

□ thread creation, destruction, status gathering, scheduling manipulation, 
suspend, and resume; 

□ multiplexing the clock (any number of threads can sleep concurrently); 

□ individualized context switching; 

□ monitors and conditions variables to synchronize threads; 

□ extends rendezvous (message send-receive-reply) for communication 
between threads; 

□ an exception handling facility that provides both notify and escape excep¬ 
tions; 

□ a way to map interrupts into extended rendezvous; 

□ a way to map traps into exceptions; and, 

□ utilities to allocate red-zone-protected stacks, and to provide some stack 
integrity checking for environments which lack sophisticated memory 
management. 

For more information on the lightweight process library see System Services 
Overview. 

Device-independent I/O and Highly efficient buffered stream I/O is integrated with formatted input and out- 
Redirection put. 

( f Virtual Memory The virtual memory management scheme promotes system resource sharing and 

portability across diverse hardware platforms. The VM system accommodates 
page-by-page sharing and employs a copy-on-write mechanism to create 
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individual copies of pages when necessary. For more information see System 
Services Overview. 

Job Control Facilities Job control provides support for multiplexing terminals between jobs, running 

several jobs at once, some in the background and others in the foreground and 
moving running jobs from background to foreground and vice-versa. These 
facilities are provided with the C shell command interpreter described in chapter 
5, Using the Shells and the csh manual page. 

Standards The SunOS operating system incorporates the System V Release 3 Base Level 

interface, reflecting System V and BSD convergence. Features from this conver¬ 
gence include: 

□ aU base level system calls including and library routines; 

□ complete System V STREAMS interface. STREAMS supports portable com¬ 
munication protocol modules and simplifies writing device drivers; 

□ full System V and BSD compatible tty interface using STREAMS; 
o System V compatible archive utility; 

□ System V batch utility and job scheduler; 

o access to Sun libraries (such as SunView) from System V programs; and, 

□ easy access to System V hbrary routines. 

For more information see System Services Overview. 

11.2. Networking Facilities The SunOS operating system includes an ISO-OSI model local networking sub¬ 
system. FuUy supported is the DARPA internet family of protocols and associ¬ 
ated addressing. The datagram (UDP) and stream (TCP) protocols are supported, 
as weU as the error message protocol (ICMP) and packet forwarding at the inter¬ 
net layer (IP). A routing information protocol allows hosts to determine the shor¬ 
test route to a destination within the local network. 

The OSI model is a layered mode, as shown in the diagram below. 
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Figure 11-3 Network Architecture 
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Remote Procedure Call The Remote Procedure Call (RPC) facility provides a mechanism whereby one 

process (the caller process) can have another process (the server process) execute 
a procedure call, as if the caller process had executed the procedure call in its 
own address space (as in the local model of a procedure call). Because the caller 
and the server are now two separate processes, they no longer have to live on the 
same physical machine. 

The RPC mechanism is implemented as a library of procedures, plus a 
specification for portable data transmission, known as the eXtemal Data 
Representation (XDR). Together RPC and XDR provide a kind of standard I/O 
library for interprocess communication. Thus programmers now have a stand¬ 
ardized access to sockets without having to be concerned with low-level details 
of socket-based IPC. 

The details of programming applications to use Remote Procedure Calls can be 
overwhelming. To aid in this task is rpcgen, a compiler, which helps you write 
RPC applications simply and directly. The rpcgen compiler accepts a remote 
program interface definition written in a language, called RPC language, which is 
similar to C. For further information see Network Programming and the 
rpcgen manual page. 

Interprocess Communication The network (interprocess) communications facilities derived from 4.2BSD are 

based on the socket. Network communication uses standard protocols and 
features of network communication include: 
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□ interprocess communications integrated into UNIX; 

□ user access to interprocess and network communication through sockets; 


□ arbitrary processes in the system may communicate in either a message or 
stream oriented fashion; and, 


□ communications through the socket mechanisms provide remote logins, 
copies, and shells over the local network. 


The Remote Procedure CaU (RPC) services provide an easier to use layer of 
abstraction than does the socket mechanisms. For more information on interpro¬ 
cess communication, see Network Programming and SunOS Reference Manual 


STREAMS STREAMS is a general, flexible facility and a set of tools for developing system 

communication services. It is intended to augment the existing character I/O 
mechanism, and thus support the evolution of system communications facilities 
— ranging from complete networking protocol suites to individual device 
drivers. STREAMS defines standard interfaces for character I/O within the ker¬ 
nel, and between the kernel and the rest of the system. For further information 
see System Services Overview. 


Reference Documentation 


To use the networking facilities refer to one or more of these documents that are 
a part of the general manual named Network Programming. This manual is 
divided into three parts. 

PART ONE, focuses on Sun’s network programming mechanisms. It includes: 

□ The Network Services overview, which introduces the fundamental network 
services without dealing with any protocol or implementation related issues. 

□ The rpcgen Programming Guide, which introduces the rpcgen protocol 
compiler and the C-like language that it uses to specify RPC applications 
and define network data. In almost all cases, rpcgen will allow network 
applications developers to avoid the use of lower-level RPC mechanisms. 

□ The Remote Procedure Call Programming Guide, is intended for program¬ 
mers who want to understand the lower-level RPC mechanisms. Readers are 
assumed to be famihar with the C language and to have a working 
knowledge of network theory. 

o The External Data Representation: Sun Technical Notes, introduces XDR 
and explains the justification for its “canonical” approach to network data 
interchange. This section also gives Sun implementation information and a 
few examples of advanced XDR usage. 

PART TWO includes a number of protocol specifications. One of these, the 
External Data Representation Protocol Specification, has been accepted (as of 
the date of this printing) as an ARPA RFC (Request for Comments). These pro¬ 
tocol specifications include: 

□ The External Data Representation Protocol Specification, which includes a 
complete specification of XDR data types, a discussion of the XDR approach 
and a number of examples of XDR usage. 
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□ The Remote Procedure Call Protocol Specification, which includes a discus¬ 
sion of the RPC model, a detailed treatment of the RPC authentication facili¬ 
ties and a complete specification of the Portmapper Protocol. 

□ The Network File System: Version 2 Protocol Specification, which includes 
a complete specification of the Mount Protocol, as well as the NFS 
specification itself. 

PART THREE documents Berkeley style, socket-Based Inter-Process Communi¬ 
cations. It includes: 

o A Socket-Based Interprocess Communications Tutorial, which assumes little 
more that basic networking concepts and introduces socket-based IP and 
includes many examples. 

□ An Advanced Socket-Based Interprocess Communications Tutorial, which 
takes up where the Tutorial leaves off. 

o Berkeley-Style IPC Implementation Notes, which describes the low-level 

networking primitives (e.g. accept (), bind () and select()) which 
originated with the 4.2BSD UNIX system. 
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System Administration 


System administration involves a collection of tasks for installing new versions 
of the SunOS operating system, maintaining hardware and software, keeping files 
and machines secure from unauthorized access, troubleshooting and upgrading 
the system. This chapter presents an overview of the utilities used for doing 
these tasks. 

System administration is divided into the following areas: 

□ initially setting up the hardware and installing the software; 

□ managing the system on a daily basis — adding new user accounts; 

□ fixing hardware and software when they break; 

□ rebooting the system; 

□ adding printere and terminals and making the system aware of their 
existence; 

□ setting up system security; and, 

□ setting up and administering the NFS file service and, if applicable, the Yel¬ 
low Pages maps. 

In general, you must be the superuser to manage the system and to perform any 
of the tasks listed above. The superuser (also called root) has powers to override 
other users’ permissions and has access to aU files and directories on the system. 
The superuser, if out of control, can wreak much havoc on the system. 

When you receive your system you should read the installation manual that came 
with your system to find out how to unpack and set up the hardware. 

To install the SunOS operating system and to configure the system using the 
suninstall utility make sure you read Installing the SunOS. 

Finally, the System and Network Administration manual contains information 
and folklore that you need to manage the system. 

The manual pages for System Administration tasks can be found in the SunOS 
Reference Manual. 
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12,1. Setup and Installation Initial setup and installation of a Sun system is aided by a special program called 

suninstall. The suninstall utility is a menu and mouse based 
configuration program to help you create the correct configuration for your sys¬ 
tem. 


Configuring the System Your system is delivered with a generic kernel — that is, the kernel is configured 

to drive every kind of device that Sun supports. The code for the device drivers 
and their data structures occupies real memory. When you install your system, 
you can reconfigure the kernel to include only those drivers for your particular 
system. The conf ig utility creates the necessary files and commands to 
configure the kernel. The procedure for reconfiguring the kernel is well 
described in Installing the SunOS, and for more information see the conf ig and 
suninstall manual pages. 


12.2. Startup and The startup and shutdown procedures automate the boot procedures as much as 

Shutdown Procedures possible. For example, there are automatic boot procedures to bring up SunOS 

and automatic reboot and file consistency checks and repairs in the event of a 
system crash. The system normally reboots itself when the power is turned on. 
However, the superuser can shut down the system and reboot it at will. 


Halting and Rebooting 
Utilities 


Checking File Systems 


The following utilities are used for halting and rebooting the system. 

The halt utility halts the system and returns control to the PROM monitor. 

The shutdown utility informs users that the system is coming down, and then 
proceeds to shut the system down at the time you specify. 

The reboot utility performs an automatic reboot. 

The sync utility forces all outstanding input/output on the system to complete 
— used to shut down gracefully. 

For further information see System and Network Administration, and the halt, 
shutdown, reboot, and sync manual pages. 

When a system has crashed, or when you are rebooting the f sck utility checks 
and repairs file system. It is an interactive repair program usually called 
automatically during the boot procedure. Features of f sck include: 

□ displays gross statistics: number of files, number of directories, number of 
special files, space used, and free space; 

□ reports duplicate use of space; 

□ retrieves lost space; 

□ reports inaccessible files; 

□ checks consistency of directories; and, 
o lists names of aU files. 

For further information see System andNetwork Administration and the f sck 
manual page. 
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12.3. Day to Day Your Sun system must be administered on an daily basis. Some of the tasks you 

Administration Tasks may need to do are described below. 


Becoming Superuser The su command temporarily changes your user ID to superuser empowering 

you with aU system rights and privileges. Superuser access is the same as root 
access. You can log in as root from scratch, or log in as yourself and then 
become superuser using su. However you become superuser, you need to know 
the root password. For more information see System and Network Administra¬ 
tion and the su manual page. 


Changing Ownership of a File The chown command changes the ownership of one or more files. At times you 

may need to give a file to someone else other than the original owner. This is 
usually true when you create a new account on the system. For more information 
see the Doing More with SunOS: Beginner’s Guide, System and Network 
Administration, and the chown manual page. 


Scheduling Events 



The cron utility schedules regular actions at specified times. Features of cron 
include: 

o actions are arbitrary programs; and, 

□ times are conjunctions of month, day of month, day of week, hour and 
minute — ranges may be specified for each. 

For more inforaiation see System and Network Administration and the cron 
manual page. 


Mounting and Unmounting The mount command attaches a file system obtained from a local device or from 
File Systems a network to a machine’s tree of directories. 

The umount command removes the file system accessed from a device or from 
the network from a machine’s tree of directories. The umount command also 
protects against removing a busy device. For more information see the System 
and Network Administration and the mount and umount manual pages. 

Creating New File Systems The newf s command creates a new file system on a device. Actually, newf s is 

a front end to the mkf s command, but newf s does much more of the hard work 
for you. 

The mkf s command makes a new file system on a device. For more information 
see the System and Network Administration and the newf s and mkf s manual 
pages. 


The Automounter The automount command lessens the need for manual mounting remote file 

systems. The mounting takes place invisibly when you refer to the remote 
filesystem with automount. Remote machines and filesystems are located by 
automount either by using a file on your machine or by using a Yellow Pages 
map. For more information see Using the Network: Beginner’s Guide and the 
automount manual page. 
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Creating Special Files The mknod command makes a node (file system entry) for a special file. Special 

files are physical devices, virtual devices, physical memory, etc. Special files 
generally reside in the /dev directory. For more information see the System and 
Network Administration and the mknod manual page. 

Dumping and Restoring Files The dump command backs up the file system stored on a specified device, selec¬ 
tively by date, or indiscriminately. 

The restore command restores a backed up file system, or selectively 
retrieves parts thereof. The restore command also has an option for restoring 
backed up file system interactively. For more information see the System and 
Network Administration and the dump and restore manual pages. 

The tar command manages file archives on magnetic tape. This command is 
useful for creating tapes of files to transfer between different locations. For more 
information see the tar manual page. 

12.4. Network Along with daily system administration tasks there are also network administra- 

Administration tion tasks which you will need to do. Basic network administration tasks 

include: 

□ On a server machine you must set up the hardware and the files so that 
clients can mount files from the server. 

□ Set up the server so it broadcasts to the network which files are available for 
clients to access. 

□ And finally, set up files on client machines that enable users to mount files 
on the server. 

For more information on network administration see System and Network 
Administration. 

12.5. System Security System security has become an important issue and is essential for preserving 

data privacy and integrity. The SunOS operating system provides the following 
security features: 

□ an auditing facility which checks valid user ID and valid passwords, file per¬ 
missions, and administrative actions; 

o file encryption; 

□ network security — an option to mount secure filesystems requiring DBS 
authentication of user and host; and, 

□ an instaU-time option to run systems at a moderately high level of security, 
patterned after the widely accepted C2 classification. 

For more information see Security Features Guide. 
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Software Development 


The SunOS operating system supports the C and assembler languages. The C 
compiler includes Sun-4 code generators which take full advantage of Sun’s 
RISC architecture SPARC . A number of software development tools are also 
support and this chapter presents an overview of the C language and tools for the 
trade. 


Other languages, such as Fortran, 
Modula-2, Lisp, and Pascal are 
available as unbundled products. 
See chapter 15, Unbundled and Third 
Party Software \ox more information. 


The diagram that follow shows the flow for source code to a compiled program. 
Since Pascal and Fortran are optional languages, but their routines can be used in 
C programs, they appear as optional features (enclosed in a dotted box). 
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13.1. C Programming 

Language 



Compiling C Programs 


Symbolic Definitions and 
Conditional Compilation 


Checking Validity of C 

Programs 



The SunOS operating system and most of the system utilities are written in C. 
For a description of C, read The C Programming Language, by Brian W. Ker- 
nighan and Dennis M. Ritchie, Prentice-Hall, 1978. 

C is a general purpose language designed for structured programming. Features 
of the language include: 

□ generalized initialization, block structure, long integers, unions, and explicit 
type conversions; 

□ supports arbitrary length variable names; 

□ supports definable data types, which include character, integer, float, double, 
enumeration types, pointers to all types, functions returning above types, 
arrays of aU types, structures and unions of aU types; 

□ operations to give machine-independent control of full machine facility, 
including to-memory operations and pointer arithmetic; 

□ macro preprocessor for parameterized code and inclusion of standard files 

□ aU procedures recursive, with parameters by value; 

□ machine-independent pointer manipulation; 

□ object code uses full addressing capability of the Sun workstation; and, 

□ runtime library gives access to aU system facilities. 

The cc command is the C compiler which compiles and/or link edits programs 
in the C language. The C compiler has been enhanced to generate the position 
independent code (pic) used to build shared libraries. For more information see 
C Programmer’s Guide and the cc manual page. 

The cpp program is the C preprocessor, which is a component of the C compiler. 
Features of cpp include: 

□ defining symbolic names; 

□ defining macros; 

□ conditional compilation; and, 

□ can also be used with FORTRAN. 

For more information see the cpp manual page. 

The lint command is a verifier for C programs. By itself the C compiler tends 
to be somewhat forgiving of programming styles which would give rise to com¬ 
piler error messages in (say) Pascal, lint reports questionable or nonportable 
usage such as mismatched data declarations and procedure interfaces, nonport¬ 
able type conversions, unused variables, unreachable code, no-effect operations, 
mistyped pointers, and obsolete syntax. It can also do full cross-module check¬ 
ing of separately compiled programs, and can check for the correct use of library 
functions. For more information see Programming Utilities and Libraries and 
the lint manual page. 
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Formatting C Programs The indent utility is a formatter for arranging C source code into standard 

styles. Features of indent include: 

□ several different styles are available for placement of comments, arrange¬ 
ment of declarations, compound-statement braces, and case labels; 

□ can format a program suitable for processing by t r o f f; and, 

□ can use a profile with your own options set. 

For more information see the indent manual page. 


13.2. Assembler 


13.3. Linker 


The as utility is the machine-level assembler for the Sun hardware family. 

Basic features of as include: 

□ creates object program normally consisting of read-only and sharable code, 
initialized data or read-write code, uninitialized data; 

□ relocatable object code is directly executable without further transformation; 

□ object code normally includes a symbol table; and, 

□ ‘ conditional jump’ instructions become branches or branches plus jumps 
depending on distance. 

For more information soe Assembly Language Reference and the as manual 
page. 


The Id utility is the link editor. Features of Id include: 

□ combine relocatable object files; 

□ insert required routines from specified libraries; and, 

□ resulting code is sharable by default. 

For more information see the Id manual page. 

From its inception, the UNIX system has been extremely strong in supporting 
software development. The system grew within a group of computer scientists 
pursuing research in computer science. Sun Microsystems continues to add to 
the quality of the programming and programming language support tools. 


13.4. Programming Tools The SunOS operating system has very strong software development support and 

to Work With Object Sun Miscrosystems continues to add to the quality of the programming and pro- 

Code gramming language support tools. 

The diagram below shows the flow from source code to object code, plus the 
major groups of tools that can be used with the object code. A later diagram 
shows more detail. 
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Figure 13-2 Major Object Code Programming Tools 
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The following diagram shows in more detail commonly used tools to work with 
object code. Each tool is then briefly described and a reference pointer is 
included for more information. 

Figure 13-3 Commonly Used Tools to Work with Object Code 



Debugging Programs at the 
Source Level 

Main features and most commonly used commands of dbx include: 

□ multiple source language debugging; 

o can display a stack back trace to show where a program stopped; 

□ can stop at specific lines in the source file, stop in specific functions, or can 
stop when specific events (such as a variable becoming equal to a designated 
value) occur; 


Revision A, of 9 May 1988 


#sun 

XS* microsystems 


The dbxtool and dbx utilities are part and parcel of the same debugging capa¬ 
bility. dbxtool is a window-based source level debugger for dbx. The dbx 
utility is a source level debugger for programs written in C, FORTRAN 77, or 
Pascal, or any combination of them. 
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□ display the value of variables by name — displaying can be indirect through 
pointers; 

□ execute designated commands when specific conditions become true; 

□ tracing facility available; 

□ can debug arbitrary processes; 

□ can debug multiple processes; and, 

□ can be used to debug the kernel. 

The dbxtool window and mouse-based interface to dbx includes all the 
features of dbx. However, you can do the most common operations (print, next, 
step, stop at, stop in, cont, and redo) by ‘pushing a button’ in the control panel. 

The dbxtool window has five areas: 

o status window displays the file and line number range of the code in the 
source window and information about the current state of the debugging pro¬ 
cess; 

□ source window usually displays the current focus of execution, though you 
can move it to any part of a source file (or to any other file); 

□ menu of command buttons contains the commands that can be constructed 
with the mouse; 

o command dialogue window provides an area where you can type commands 
and where the commands obtained from the buttons window are echoed; 
and, 

□ variable values display window (generally called the “display window”) 
displays the values of selected variables and expressions whenever execution 
halts. 

In addition to the standard ‘buttons’ in the control panel, you can construct your 
own buttons, either as you go, or in a dbxtool profile. The picture below 
shows a dbxtool window with a program being operated on. 
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Figure 13-4 Example dbxtool Window 



lAuaiting Execution ———| 

|File Displayed: ./example.c Lines; 13-32 || 

I 

♦/ 

struct few few2 " { 3, 4, NULL, "world" } ; 
struct few faul - { 1, 2, &few2, "hello" } ; 

/* 

* write a main program to use the structures 
*/ 

mainO 

{ 

/• 

* declare the variable *fewp 

* to p[oint to a few-type structure 
*/ 

struct few *fewp; 

/* 

* print out a message 
•/ 

f for (faup “ &fewl; faap !“ NULL; fewp -> next) { 

printfC"%s ", fewp -> message); 

} 

> 

f print ][print *]( next ][ step ][stop at][ cont ][stop 1n]( clear ]f where ] 

[ up |[ down ][ run J 


Reading symbolic information... 

Read 155 symbols 
(dbxtool) run 

Running: example 
hello world 

execution ccmpleted, exit code is 8 

program exited with 8 

(dbxtool) stop at "example.c":29 

(2) stop at "example.c";29 

(dbxtool) print fewp 

"fewp" is not active 

(dbxtool) ^ 

1 



For more infonnatioii see Debugging Tools and the dbxtool and dbx manual 
pages. 


Debugging at the Machine The adb utility is a very low-level symbolic debugger. It is now largely super- 

Level seded by dbxtool and dbx. Some of adb’s features include: 

□ examine arbitrary files with no limit on size; 

□ interactive breakpoint debugging with the debugger as a separate process; 
o symbolic reference to global variables; 

□ patching; 

□ stack trace for C programs; 

□ Output formats of: 1-, 2-, or 4-byte integers in octal, decimal, or hexade¬ 
cimal, single and double floating point, character and string; and 

□ disassembled machine instructions. 

For more information see Debugging Tools and the adb manual page. 
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Building and Maintaining 
Libraries 


Dumping File Contents 


Displaying the Namelist 


The ar utility is a library maintenance utility. The principal use of ar is to build 
and to maintain object code libraries used by Id, the link editor, ar can be used 
as a general utility for collecting groups of files into a single unit. Major features 
of ar include: 

□ maintain archives and libraries; 

□ combine several files into one for housekeeping efficiency; 

□ create new archive; 

□ update archive by date; 

□ replace or delete files from the archive; 

□ display table of contents (what files are in the archive); and, 

□ retrieve files from archive. 

For more information see the ar manual page. 

The od command dumps the contents of any file. Output options include; any 
combination of octal or decimal by words, octal by bytes, ASCII, opcodes, and 
hexadecimal. The range of dumping also is controllable. For more information 
the od manual page. 

The nm utility displays the namelist (symbol table) of an object program, and 
provides control over the style and order of names that are printed. For more 
information see the nm manual page. 


Displaying Size of a Program The size utility displays the memory requirements of one or more object files. 

For more information see the size manual page. 


Stripping Relocation and The strip utility removes the relocation and symbol table information from an 

Symbol Table object file to save space. For more information see the strip manual page. 


Search for ASCII Strings in The strings utility is a useful tool to locate ASCII strings in a binary file. For 
Binary File more information see the strings manual page. 


13.5. Performance Analysis The SunOS operating system supports several facilities for monitoring perfor- 
Tools mance of software, ranging from a simple command to reporting the time a pro¬ 

gram takes to execute, to a code-coverage tool providing detailed statement-by¬ 
statement analysis of a program. 


Timing a Program The time utility is a simple system command that produces a report on how 

much time a given program takes to execute. For more information see Pro¬ 
gramming Utilities and Libraries and the time and /usr/bin/time manual 
pages. 

Profiling a Program The prof utility constructs a profile of time spent per routine from statistics 

gathered by time-sampling the execution of a program, prof also displays sub¬ 
routine call frequency and average times for C programs. For more information 


Asun 

XT mtcrosystems 


Revision A, of 9 May 1988 



114 Sun System Introduction 


see Programming Utilities and Libraries and the prof manual page. 

The gprof constructs a call-graph profile for a program. The call-graph profile 
not only includes the ‘flat’ profile in the same style as prof, but it also displays 
the callers of a specific routine, and the number of times a routine was called or 
called another routine. For more information see Programming Utilities and 
Libraries and the gprof manual page. 

The tcov utility is a code coverage tool that satisfies two widely divergent 
needs; 

o it increases the resolution of prof and gprof down to the statement level, 
thereby providing extremely detailed analysis of where a program spends its 
time; and, 

□ it provides a report on which parts of a program are actually being executed. 
Such a report can be used (for instance) to discover how much testing a 
given set of regression tests are actually doing. 

For more information see Programming Utilities and Libraries and the tcov 
manual page. 


13.6. Program Generation 
Tools 


Building and Maintaining The make utility is an indispensable tool for making sure that large programs are 

Programs properly compiled with minimal effort, make has several unique features, 

including: 

o ability to specify through a control file (called a makefile) what you want to 
build — called a target, things the target depend upon — called dependen¬ 
cies, and to go about constructing the target from its dependents — rules', 
and, 

□ has innate rules that specify the dependencies between object files and the C 
compiler, yacc, lex, etc. 

For more information see Programming Utilities and Libraries and the make 
manual page. 

Maintaining History The sees utility is the Source Code Control System, sees maintains and con¬ 

trols multiple versions of text files, and also maintains the multiple versions in an 
sees database. Features of sees include the ability to: 


^ The Mythical Man Month 


Frederick Brooks pointed out^ that there is a world of difference between a pro¬ 
gram (something that a couple of guys can cobble together in their garage over a 
weekend) and a programming systems product (a whole system that must work 
together and be documented). The SunOS operating system supplies many tools 
for assisting in the job of generating large systems. Two of the tools that assist 
programming in the large are make, building and maintaining consistency, and 
s c c s for maintaining history. 


Generating a Call Graph 
Profile 


Analyzing Code Coverage 
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□ create an SCCS database for a file to establish the initial version; 

□ produce a read-only copy of a file from the database for compiling or any 
other activity that doesn’t involve changing the file; 

□ edit a writable copy of a file from the database for making changes; and, 

□ delta the modified copy of the file back into the database when you are 
satisfied with the changes you made. The delta is a record of the differences 
between this version and the last version. The current version of the data¬ 
base file is thus a complete list of aU changes made during the file’s histoiy. 

For more information see Programming Utilities and Libraries and the sees 
manual page. 

13.7. Compiler The lex and yaee utilities began life to assist generating lexical analyzers and 

Development Tools syntactic parsers for compiler development. Over time, they have been applied 

to other areas such as a language for describing equations in document produc¬ 
tion (eqn), for the syntax analyzer for the make program, and for a language to 
describe pictures for document production (pic). The lex and yacc utilities 
are constructed to work together, as shown in the figure below. 
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Figure 13-5 lex and in Program Development 



Generating Lexical Analyzers The lex utility generates lexical analyzers. Features of lex include: 

□ converts specification of regular expressions and semantic actions into a 
recognizing subroutine; 

□ arbitrary C functions may be called upon isolation of each lexical token; 

□ fuU regular expression, plus left and right context dependence; and, 

□ resulting lexical analyzers interface cleanly with yacc parsers. 

For more information see Programming Utilities and Libraries and the lex 
manual page, 

’h 

include: 
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□ BNF syntax specifications; 

□ precedence relations; and, 

□ accepts formally ambiguous grammars with non-BNF resolution rules. 

For more information see Programming Utilities and Libraries and the yacc 
manual page. 

13.8. Other Programming In addition to the tools described above, there are some ancillary utilities that 
Tools find diverse applications. 

Macro Processing The m4 utility is a general purpose stream-oriented macroprocessor that recog¬ 

nizes macros anywhere in text. Some features of m4 include: 

□ syntax fits with functional syntax of most higher-level languages; and, 

□ can evaluate integer arithmetic expressions. 

For more information see Programming Utilities and Libraries and the m4 
manual page. 


Calculators 


The dc, an interactive programmable desk calculator and be, C-like interactive 
interface to the dc desk calculator are also good programming tools. For more 
information see, chapter 3, SunOS — User Features. User Access and Com¬ 
mands, and Games, Demos & Other Pursuits, and the dc and be manual pages. 
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13.9. Summary of The following table contains an alphabetical list of the software development 

Language Utilities utilities described in this chapter. 

Table 13-1 Summary of Language Processing Programs 


Program 

Name 

Function 

adb 

debug at the machine level 

ar 

build and maintain libraries 

dbx 

debug programs at the source level 

dbxtool 

debug programs at the source level 

gprof 

generate a call graph profile 

Id 

link programs 

lex 

generate lexical analyzers 

lint 

check validity of C programs 

m4 

macro processor 

make 

build and maintain programs 

nm 

display the namelist 

od 

dump file contents 

prof 

profile a program 

sees 

control revision history 

size 

display size of a program 

strip 

strip relocation and symbol table 

tcov 

analyze code coverage 

time 

time a program 

yacc 

generate syntactic analyzers 
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14.1. SunCore 

14.2. SunCGI 

14.3. Pixrect 












Graphics Software 


Sun Microsystems graphics software supports several standards. The figure 
below illustrates the relationships between the various graphics packages in the 
SunOS 4.0 Release. 

Figure 14-1 Graphics Standards 



Sun Microsystems supplies the following graphics packages in SunOS 4.0: 

14.1. SunCore SunCore is an implementation of the ACM SIGGRAPH Core System. SunCore is a 

comprehensive package of engineering graphics software providing support for 
interactive 3D graphics application programs. SunCore conforms to level 3C 
(dynamic output with 3D scaling, rotation and translation) of the Core 
specification for output primitives, and to level 2 (complete input) for input prim¬ 
itives. For more information see SunCore Reference Manual. 
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14.2. SunCGI 
CGI was a proposed standard when 
SunCGI was written. CGI does not 
appear to be moving toward appro¬ 
val in the near term, while GKS, 
PHIGS, and CGM have been 
approved as standards. The pro¬ 
cess of transition to new standards 
means a phase-out of SunCGI by 
SunOS 5.0. This provides 18 
months for transition to new 
software technology. 


SunCGI is an implementation of a draft of the ANSI Computer Graphics Inter¬ 
face (CGI). Previously, CGI was known as the Virtual Device Interface (VDI) 
standard. SunCGI provides access to low-level graphics device functions 
without the restrictions, benefits, or overhead of higher-level graphics packages 
like SunCore . SunCGI is useful for 2D graphics programs that do not require 
segmentation or transformations. The absence of segmentation from SunCGI 
makes drawing diagrams faster and simpler, but does not provide automatic pic¬ 
ture regeneration. SunCGI programs are usually smaller and more efficient than 
SunCore programs with similar functionality. For more information see SunCGI 
Reference Manual. 


14.3. Pixrect The Pixrect graphics library is a set of RasterOp routines common among all Sun 

workstations. With these routines, application programs can be written that 
access the display on all Sun products. 

In the Sun graphics software world, the Pixrect library is a low-level package, sit¬ 
ting on top of the device drivers. For most applications, the higher-level abstrac¬ 
tions available in SunView and the Sun graphics libraries are more appropriate. 
For more information see Pixrect Reference Manual. 
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Unbundled and Third Party Software 


This chapter introduces software products which are available for purchase, but 
are not part of the standard SunOS operating system, These software products are 
termed ‘unbundled’, since they are not included in the software you receive when 
you purchase your Sun system. Also included in this chapter is an introduction 
to the third party software program called Catalyst and the Sun User’s Group. 

15.1. Unbundled Software There are numerous software packages available for applications in program¬ 
ming, data communication, artificial intelligence, networking, graphics, win¬ 
dows, and office automation. Software for each of these applications is described 
below. 

Software Development High-performance compilers are available for the most commonly used 

languages including: an enhanced ANSI FORTRAN 77 with VAXA^MS FOR¬ 
TRAN 4.0 extensions, Pascal, Ada, Modula-2, and Sun Common Lisp for 
artificial intelligence. 

Sun’s core languages feature interlanguage calling (the ability to use FORTRAN 
routines in a C program) and have full access to systems, graphics, networking, 
and user interface packages. There is also a family of cross compilers for the 
core languages that produces executable binaries for multiple Sun architectures 
from a single development machine. The cross compilers eliminate the need to 
port individual software packages to each architecture,. 

SunPro — Interface for Sun SunPro is a set of integrated program development facilities that provide a con- 

Languages sistent user interface for standard Sun languages. Features of SunPro include: 

□ dbxtool which provides window and mouse control for almost all debug¬ 
ging operations and also provides text editing within the debugger; 

o an enhanced make command which includes automatic dependency genera¬ 
tion and tracking, command consistency, and a fuUy functional lib member 
notification procedure; 

□ f i 1 emer ge, based upon the UNIX System V s di f f procedure. With 

f ilemerge you can scroll through versions of different files and recently 
merged files; and, 

□ a common compiler driver which provides a consistent compiler interface 
and a standard mechanism for adding extra compilers. 
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SunLink — Data 
Communication 


SunUNIFY 


SunSimplify 


SunLink is Sun’s family of data communications software and hardware pro¬ 
ducts. These products provide multivendor compatibility, wide-area networking, 
and a migration path to emerging communication standards. 

Using SunLink products you can link IBM mainframes to DEC minicomputers, 
word processors, PCs and other computer systems. With SunLink wide-area 
communication products, geographically distributed networks work together as if 
they were in one location and benefit from the merged NeWS and X window sys¬ 
tem. 

There are numerous products available in the SunLink family for data communi¬ 
cation in: 

□ wide-area and multivendor networking; 

□ communication through packet-switched networks; and 

□ IBM and DEC connectivity. 

SunUNIFY is an extended relational database system that provides complete 
development facilities for interactive and networked applications. Features of 
SunUNIFY include: 

□ ad hoc queries and updates in SQL, and English-like language; 

□ concurrent networked database access; 

o formatted reports, statistics, and form-letter generation; 

□ fast data access from programmed applications; 

□ forms-based data entry and query tools; 

□ tools to generate custom forms-based applications; logical data integrity 
checking and data access protection; and, 

□ database dump, load, logging, and crash recovery. 

SunSimplify is a set of front-end interfaces for SunUNIFY. SunSimplify incor¬ 
porates graphics, the mouse, and programming interfaces. These features offer 
advanced user database tools and facilitates development of custom interactive 
database applications. 

The major components of SunSimplify include: 

□ Schemadesign, a graphical SunView window-based tool for creating and 
displaying data schemas; 

□ Databrowse, a unique SunView window-based data display and update tool 
for accessing database information in an object-oriented fashion; 

□ local and remote access to the relational query language, report generator, 
and menu capabilities of the underlying database system; 

□ ERIC, a programmer’s interface to the underlying database system; and, 

□ local and remote data access on the network. 
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SunINGRES SunINGRES is another available full-featured, relational database management 

system. Features of SunINGRES include: 

□ concurrent access to databases in a heterogeneous network; 

□ two high-level data-manipulation and query languages (SQL and QUEL); 

□ precompilers for SQL and QUEL statements embedded in other languages; 

□ sophisticated query optimization; 

□ interactive, forms-based Visual Programming tools; 

□ transactions for reliability, recoverability, and integrity; and, 

□ relational data model with integrated data dictionary. 

SunTrac — Project SunTrac project management system consists of tools to aid project management 

Management Software problems. SunTrac blends sophisticated analysis with networked computing 

technology. Tools of the SunTrac system include: 

□ SKETCH, a mouse and menu driven graphical network editor which creates, 
displays, and enters data to PERT network diagrams; 

□ TRAC (total risk analysis calculation), a new algorithm which rapidly 
analyzes risk to cost, schedule, and resources; 

□ LEVEL (interactive/automatic resource leveling tool), a mouse-driven input 
to the Gantt chart and Resource profile graphically levels resource usage, 
and schedules and controls activities; 

□ ASSIGN (optimal overtime allocation tool), plans the least-cost reduction in 
project schedule keyed to a user-selected productivity factor; 

o PROFILE (graphic summary), displays, analyzes, and prints staffing level 
and cost profiles for the selected network and data; 

□ REPORT (activity reports), reviews, sorts, and extracts detailed planning, 
scheduling, and analytical information; and, 

□ HELPTRAC, graphically browses and searches online help text. 

SPE — Symbolic Programming The Symbolic Programming Environment (SPE) provides sophisticated program 
Environment development tools for artificial intelligence and symbolic programming. SPE is a 

set of specially designed tools for efficient program development in Lisp and 
other symbolic languages. The tools facilitate rapid prototyping. Features of 
SPE include: 

□ editor — a special Emacs-style editor for developing Lisp code, with a set of 
Lisp libraries for extending the editor’s functionality; 

□ common Lisp window manager — a toolkit of Lisp functions that define a 
rich set of windowing operations for Lisp programmers. 

□ Lisp listener — a high-level Lisp interpreter; similar to the UNIX shell; 

o window-based debugger — a window-oriented debugging tool that provides 
information on the state of the program, such as function call tracing, passed 
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arguments, local variables, and stack information; 

□ widow-based data inspection — an interactive tool for inspecting instances 
of Lisp data structures in an application; 

□ window-based single stepper — a trace mechanism for following the line- 
by-line execution of Lisp source code; 

□ window-based trace — a tools that monitors the execution of a particular 
function(s) during runtime; 

□ source code analyzer — produces a set of relationships of the functions in 
the source code where users can follow the control of flow while editing the 
program; 

□ source code finder— a tool for finding the specific source code for any 
given function; 

□ apphcation manager — an abstract representation of the entire application 
that keeps track of the dependencies of the source files and functions 
involved in an application; and, 

□ LfNIX interfaces — a set of library functions that create interfaces between 
Lisp and UNIX that integrate the Sun’s networking tools with the symbolic 
application programs. 

XI 1/NeWS — Along with SunView/SunWindows, Sun has expanded its window systems offer- 

Network/extensible Window ing to include Network/extensible Window System (XI 1/NeWS). The 

System XI 1/NeWS product provides a window system in a networked environment. 

XI 1/NeWS merges Version 11 of the X Window System from MIT with NeWS, 
which provides Sun’s unified, native window system and forms the foundation 
for Sun’s future window systems technology. This combined technology is the 
network-based window platform for the development of portable, flexible, and 
high-performance window-based applications. 

SunGKS — Sun Graphics SunGKS is an implementation of the Graphical Kernel System (GKS), an appli- 

Kemel System cation software interface standard developed by the International Standards 

Organization for interactive computer graphics. It is a library of functions that 
support floating point-based 2D graphics apphcations on Sun workstations. The 
GKS specification uses the notion of a workstation to indicate a virtual display 
surface. SunGKS uses the windowing facilities provided by SunView to manage 
multiple GKS workstations on the same physical Sun workstation. 

Here is an overview of SunGKS functionality: 

□ control functions control the current state of GKS; 

□ primitives are functions for drawing lines, fiUed polygons, collections of 
markers, text and virtual bitmaps; 

□ attributes control the graphical appearance of the primitives. For example, 
the polyline primitive has three attributes: line width, line style and line 
color. Attributes can be determined individually or in named groups called 
representations’^ 
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□ segments collect primitives into static groups called that can be scaled, 
translated and rotated; 

□ transformations control the graphical transformations between world coordi¬ 
nates, normalized device coordinates (NDC), and device coordinates (DC); 

□ input functions manage the use of input devices with application programs 
through an abstract model called a logical input device. This scheme pro¬ 
vides portability of applications. Each GKS implementation maps these log¬ 
ical input devices onto available physical input devices like the mouse and 
keyboard; 

□ metafiles provide a mechanism for passing graphical data between GKS sys¬ 
tems (including systems not manufactured by Sun); and, 

□ inquiry functions permit examination of the current state and capabilities of 
SunGKS. 

GKS is a functional standard supported in a given language or environment with 
specified bindings. SunGKS is implemented in C with a software interface based 
on C functions. SunGKS also includes a FORTRAN compatibility library that 
allows FORTRAN applications to make calls on the C functions of SunGKS . 


SunAlis — Office Automation 
System 

o a document composer with automatic text formatting; 

□ universal graphics editor; 

□ spreadsheet with built-in goal analysis; 

□ personal and office database management; 

□ DIF, UNIX file import/export; 

o personal and shared document filing; 

□ electronic mail and messaging; 

□ personal time management; 
o calendar management; and, 

□ archiving and backup utilities. 


The SunAlis office software system lets users share any type of data — text, 
graphics, spreadsheets or databases. It provides document preparation and 
management tools for analyzing, communicating and sharing different types of 
information. Features of SunAlis include: 


NSE — Sun’s Network 
Software Environment 



The Sun Network Software Environment (NSE) is a network-based object 
manager for software development. NSE facilitates parallel development of large 
software systems, maintains consistency and completeness of objects being 
developed, and is extensible to different types of objects. Parallel development is 
supported through an optimistic concurrency control mechanism, where develop¬ 
ers do not acquire locks before modifying objects. Instead, developers copy 
objects, modify the copies, and merge the modified objects with the originals. 
NSE provides copy operations on units that are complete and consistent sets of 
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objects. These copy operations produce logical copies; a physical copy of an 
object is not made until the object has been modified. 

Features of NSE include: 

□ compatibility with today’s tools for a clear migration path to more advanced 
technology; 

□ complete programmatic interface for a consistent and standard mechanism 
for software tool integration; 

□ supports all development objects produced during the software life cycle; 

□ transparent network-wide access to NSE objects making objects local 
regardless of physical location; 

□ NSE environments are complete and isolated creating noninterference for 
object sharing; 

□ a notification utility for monitoring object changes network-wide; 

□ a link facility for traceability through the connection of independent objects; 

□ a version control system which records versions and histories of all develop¬ 
ment objects; and, 

□ consistent window and mouse-based user interface. 

PC Compatibility Products Products available for PC’s include PC-NFS, a network file system for personal 

computers, PC-NFS electronic mail and network backup system, and PC-NFS 
programmer’s toolkit. 

The PC-NFS network file system integrates IBM PCs (and 100 percent compati¬ 
ble systems) into local area networks (LANs), allowing them to share informa¬ 
tion and resources with workstations, minicomputers, superminicomputers, and 
even personal computers. 

The PC-NFS electronic mail and backup system allow PC users to access 
network-wide resources in a multivendor environment. The PC-NFS electronic 
mail system is a full-featured, window-driven facility for electronic mail across 
different hardware architectures, networks, and operating systems. The PC-NFS 
backup is a network resource and management facility that lets you back up local 
or distributed files directly to a mass-storage device or tape drive on most NFS 
servers. 

The PC-NFS programmer’s toolkit provides a set of network development tools 
that bridge DOS and UNIX systems (SunOS, System V, 4.2BSD, Ultrix). This 
toolkit is a set of libraries that run on IBM PC, PC/XT, and PC/AT, and other 
100 percent compatible machines using DOS 3.0 and PC-NFS 2.0 or higher. The 
toolkit offers a single programming interface across a host of network boards, 
and the libraries can be used to develop a distributed database. 

Also available is the Sun Integrated Personal Computer (SunIPC), a coprocessor 
boards and software product for VME-based Sun workstation computers. The 
SunIPC board lets you run PC-DOS application software in a window on a Sun 
workstation. The SunIPC gives you access to the full range of software available 
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to IBM PC, PC/XT, PC/AT, and compatible computers. 

For More Information For more information on any of the unbundled products described above call 

your Sun sales office. 


15.2. Catalyst — the Third 
Party Program 


Sun’s Catalyst program is built upon a relationship established with third-party 
hardware and software vendors. These vendors have implemented their special¬ 
ized application software or hardware to run on Sun systems. The third party 
program is an ongoing part of Sun’s marketing organization to provide the widest 
range of applications to serve your computing needs. Currently there are more 
than 5(X) third party vendors in the Catalyst program. Listed below are the major 
application areas as listed from the Catalyst catalog. For detailed information 
and people to caU, please refer to the appropriate section of the Catalyst catalog. 

□ electronic publishing and office automation; 

□ artificial intelligence; 

□ software engineering; 

□ earth resources engineering; 
o finance; 

□ biological and physical sciences; 

□ electrical engineering; 

□ add-on hardware; 

□ mechanical/architectural/civil engineering; 
o manufacturing; and, 

□ miscellaneous. 


15.3. Sun User Group The Sun User Group is an independent organization of individuals and institu¬ 

tions who share a common interest in Sun workstations and related products. 

The Sun User Group encourages exchange of information between Sun 
workstation users and Sun Microsystems. The group collects and disseminates 
techniques, software, documentation, procedures, and related interesting informa¬ 
tion. 


Donated Software Tape The Sun User Group offers a distribution tape of donated software at a nominal 

charge. The software is contributed from the user community and is not sup¬ 
ported by Sun Microsystems. Among the many items of software on the distri¬ 
bution tape can be found: 

□ device drivers for hardware products that are not a directly supported part of 
the Sun workstation product family; 

□ utilities that run in the Sun Windows environment; 

□ communications enhancements; 
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□ compilers for languages other than those that Sun Microsystems supports 
directly; 

□ editors and spreadsheets; 

□ mail handlers; 

□ games; and, 

o system administration tools. 

You must be a member of the Sun User Group, and a Sun customer, to get a copy 
of the Donated Software Tape. 
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Sun Technical Documentation 


Included with your Sun system is a comprehensive package of documentation for 
the hardware and the SunOS operating system. The documentation is grouped 
into a docubox. The docubox contains four miniboxes, including; 

□ System Administration Manuals', 

□ Reference Manuals’, 

a Beginner’s Guides', md, 

□ Programming Guides. 

/* ^ Hardware manuals are packaged separately from the docuboxes, but all are 

included when you purchase a Sun system. 

The figure which follows illustrates the basic documentation miniboxes. The 
System Administration minibox contains a Read This First (RTF) for the entire 
docubox. Each minibox, including System Administration, are also accompanied 
with an RTF. 
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Figure 16-2 Beginner’s Guides Minibox 



16.1. Beginner’s Guides The Beginner’s Guides minibox includes the following manuals: 

□ Sun System Introduction — an introduction to the Sun family of workstations 
and the SunOS operating system. This manual is a roadmap for what is 
available and where to find more information. 

□ Getting Started with SunOS: Beginner’s Guide — is a basic introduction to 
SunOS user commands. 

□ Setting Up Your SunOS Environment: Beginner’s Guide — describes how to 
customize your shell, editor, etc. 

a Self-Help with Problems: Beginner’s Guide — helps you diagnose and solve 

problems common to beginning users. 

o SunView 1 Beginner’s Guide — isan introduction to the SunView window 
environment. 

□ Mail and Messages: Beginner’s Guide — isan introduction on how to send 
and receive mail and messages. 
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□ Doing More with SunOS: Beginner's Guide — describes more advanced user 

commands. 

a Using the Network: Beginner’s Guide — describes how to use the network 

effectively. 
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Figure 16-3 Programmer’s Guides Minibox 





16.2. Programmer’s 
Guides 


The Programmer’s Guides include the following manuals: 

o C Programmer’s Guide — describes using the C language under SunOS . 

□ Assembly Language Reference — describes MC680x0 programming under 
SunOS. 
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□ Programming Utilities and Libraries — describes software development 
tools. 

□ Debugging Tools — describes debugging under SunOS. 

p Network Programming — a programmer’s reference manual covering 

rpcgen, remote procedure calls (RPC) and socket based interprocess com¬ 
munication (IPC). 

□ Writing Device Drivers — programmer’s reference manual covering aU of 
the hardware and kernel interfaces relative to the structure of device drivers. 
Also includes all STREAMS tutorial and reference material. 

□ Floating-Point Programmer’s Guide — describes floating point usage and 
performance under SunOS. 

□ SunView 1 Programmer’s Guide — a guide and reference manual for 
programmer’s using SunView user interface tool kit to develop window- 
based applications. 

□ SunView 1 System Programmer’s Guide — provides additional information 
for low-level SunView and SunWindows packages and routines. 

□ Pixrect Reference Manual — a reference manual describing a set of 
RasterOp graphics routines common among all Sun workstations. Describes 
how applications can access a frame buffer in a device-independent way 
across the Sun product line. 

□ SunCGI Reference Manual — a reference manual for Sun’s 2-D integer- 
based, device-level graphics interface based upon Computer Graphics Inter¬ 
face (CGI), proposed by the American Standards Institute (ANSI). 

□ SunCore Reference Manual — a reference manual for Sun’s 3-D graphics 
software interface based upon the ACM/SIGGRAPH core proposal. 
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Figure 16-4 System Administration Minibox 



16.3. System 

Administration 

Manuals 


The System Administration Manuals include the following: 

o SunOS 4.0 Change Notes — describes the new features for SunOS release 

4.0. 

□ Installing the SunOS — installation instructions for loading the SunOS 
operating system on to your Sun hardware. 

□ System and Network Administration — describes how to administer an 
already running system, set up with suninstall. Also describes adminis¬ 
tration procedures for the system itself, and if applicable, procedures for the 
system’s network environment. 

□ Security Features Guide — describes SunOS security features for the pro¬ 
grammer, user, and administrator. Also includes information on network 
security. 
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□ PROM User’s Manual — describes power-up sequences, tests, and PROM 
monitor commands, including EEPROM and NVRAM layouts for all Sun 
systems. 

□ Sun System Diagnostics — provides a user guide description for the Sun Sys¬ 
tem Diagnostics Program (sysdiag). The sysdiag program is a system 
exerciser found on the SunOS distribution tape. 
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Figure 16-5 Reference Manuals Minibox 



16.4. Reference Manuals The Reference Manuals include the following: 

□ SunOS Reference Manual — the manual pages for all Sun system commands 

and system calls. The manual pages are divided into eight sections: 

1. user commands 

2. system calls for the C language 

3. library routines for the C language 

4. devices 

5. file formats 

6. games and demos 

7. miscellaneous tables 
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8. maintenance commands 

□ System Services Overview — an introduction and overview for all system ser¬ 
vices and interfaces. 

□ Editing Text Files — describes the text editors, vi, ex, ed, and sed. Also 
describes how to scan files using grep and awk, and commands for com¬ 
paring files and directories. 

□ Using nrof f and trof f— a reference guide for the nrof f/trof f for¬ 
matting programs. 

□ Formatting Documents — a tutorial for macro packages and nrof f/trof f 
preprocessors for creating tables, equations, and bibliographies. 

□ Global Index — and index for all SunOS release documentation. 

16.5. Hardware Manuals Accompanying the docubox manuals is a set of hardware manuals. What kind 

and how many hardware manuals you receive depends upon your system 
configuration. Every system includes an enclosure install type of manual and 
install manuals for each CPU board you receive. These manuals provide instruc¬ 
tions on how to set up your system hardware. There is also a manual(s) for the 
cardcage slot assignment and backplane configuration procedures. 
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change, 56 
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ee — C compiler, 107 
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password, 47 
priority nice, 43 
working directory, 55 
check spelling — spell, 79 
eheekeq, 79 

checking spelling in text files, 68 

eheeknr, 79 

checksum file, 60 

ehgrp — change group, 56 

ehmod — chmod executable, 42 

ehmod — change access permissions, 56 

client machine, 15 

clocktool, 34 

emp — binary compare files, 59 

code coverage, 114 

col, 79 

command interpreter, 17 

at — schedule processes, 43 
Bourne Shell, 41 
C sheU, 41 

chmod — chmod executable, 42 
cut — cut lines, 42 
echo — echo arguments, 42 
expr — evaluate expressions, 43 
grep — grep pattern searching, 42 
kill — kill process, 43 
nice — change priority, 43 
nohup — block hangups, 43 
paste — paste lines together, 42 
sed — sed editing files, 42 
sleep — suspend process, 43 
tee — divert output, 43 
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t r — tr translating characters, 42 
wait — wait on process, 43 
command mteipreters, 39 thru 43 
communications, 83 thru 84 
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mail, 83 
mesg, 83 
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directories, 59 
files, 59 

counting things in text files, 66 
cp — copy files, 59 
creating 

cursors or icons, 29 
directory, 56 

fonts with— f ontedit, 30 
links to files, 56 
current directory, 53 
display name of, 56 
cursors 

creating with iconedit, 29 
cut — cut lines, 42 

D 

data formats 
convert, 60 

date — display date and time, 48 

dbx debug tool, 112 

dbxtool, 32 

dbxtool debug tool, 110 

dc desk calculator, 117 

dd — convert file formats, 60 

decrypting text files, 68 

defaultedit, 28 

defaults 

editing with defaultedit, 28 
deleting 

directory, 56 
files, 57 
derof f, 79 
desk calculators 
be, 48, 117 
dc, 117 

determine type of file, 58 
device-independent I/O, 91 
df — display free space, 57 
directory, 53, 53 thru 60 
access permissions, 53 
change access permissions, 56 
change working, 55 
copy, 59 
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display name of working, 56 
displaying names of, 55 
home, 53 
linking to, 56 
move, 56 
remote copy, 59 
removing, 56 
rename, 56 
working, 53 
display 

commonality between text files, 68 


display, continued 
date and time, 48 
differences between text files, 67 
head of file, 59 

name of working directory, 56 
namelist— nm, 113 
size of object size, 113 
tail of file, 59 
time— clocktool, 34 
usage of file system, 57 
display editor — vi, 64 
divert output— tee, 43 
document preparation, 73 thru 80 
checkeq, 79 
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col, 79 
derof f, 79 
eqn, 76 

macro packages, 75 

-man macro package, 76 

-ms macro package, 76 

nroff, 75 

ptx, 79 

refer, 79 

spell, 79 

tbl, 77 

troff, 75 

documentation, 135 thru 144 

beginner’s guides, 137 thru 138 
hardware manuals, 144 
programmer’s guides, 139 thru 140 
reference manuals, 143 thru 144 
system administration manuals, 141 thru 142 
donated software tape, 131 
du — display disk usage, 57 
dump file— od, 113 

E 

echo — echo arguments, 42 
editing 

defaults— def aultedit, 28 
fonts — fontedit, 30 
text— textedit, 27 
editing text files, 64 thru 65 
ed, 65 
ex, 65 
sed, 65 
vi, 64 

electronic mail— mail, 83 
encrypting text files, 68 
eqn, 76 

equation formatting — eqn, 76, 79 
erasing 

directory, 56 
files, 57 

evaluate expressions — expr, 43 
execution profile, 113 
expr — evaluate expressions, 43 
expression evaluation — expr, 43 
External Data Representation, 93 
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file, 53, 53 thru 60 

access permissions, 53 
binary compare, 59 
change access permissions, 56 
checksum, 60 
convert data formats, 60 
determine type of, 58 
display head of, 59 
display tail of, 59 
page through, 59 
split, 59 

file — find file type, 58 
file dump— od, 113 
file system, 13 

directory, 53 thru 60 
display usage, 57 
file, 53 thru 60 
network, 15 
remote mounting, 15 

files 

concatenate, 58 
copy, 59 
deleting, 57 

displaying names of, 55 
erasing, 57 
finding, 57 
Unking to, 56 
move, 56 
remote copy, 59 
removing, 57 
rename, 56 
find — find files, 57 
finding 

files, 57 

what people are doing, 48 
who is logged in, 48 
fontedit, 30 
fonts 

editing with fontedit, 30 
format C programs — indent, 108 
format conversion 
for files, 60 

formatting documents, 73 thru 80 
checkeq, 79 
checknr, 79 
col, 79 
deroff, 79 
eqn, 76 

macro packages, 75 

-man macro package, 76 

-ms macro package, 76 

nrof f, 75 

ptx, 79 

refer, 79 

spell, 79 

tbl, 77 

troff, 75 
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gaining access, 47 

generate lexical analyzer— lex, 116 
generate syntax analyzer— yacc, 116 
gprof — call-graph profile, 114 
graphics software, 121 thru 122 
Pixrect, 122 
SunCGI, 122 
SunCore, 121 

grep — grep pattern searching, 42 
group 

change, 56 

H 

hardware manuals, 144 
hardware products, 7 thru 10 
head — display head of file, 59 
head of file 
display, 59 

hierarchical file system, 13 
history keeping — sees,114 
home directory, 53 

I 

iconedit, 29 
icons 

creating with iconedit, 29 
interactive 

debugging with dbxtool, 32 
interactive command inteipreter, 17 
interactive line editor — ed, 65 
interactive line editor — ex, 65 
interactive screen editor — vi, 64 
interprocess communication, 93, 94 

J 

job control, 92 

K 

kill process — kill, 43 

L 

languages, 105, 108 

adb debug tool, 112 
assembler, 108 
C, 107 thru 108 
cc —C compiler, 107 
epp — C preprocessor, 107 
dbx debug tool, 112 
dbxtool debug tool, 110 
gprof — call-graph profile, 114 
indent — format C programs, 108 
link editor, 108,108 
lint — verify C programs, 107 
object code tools, 108 thru 118 
performance analysis, 113 thru 118 
prof — execution profile, 113 
t cov — code coverage/statement analysis, 114 
time — time program execution, 113 
lexical analyzer generators, 115 thru 117 
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lexical generator — 1 ex, 116 
library maintainer— ar, 113 
lightweight process library, 91 
line editor 
ed, 65 
ex, 65 

link editor, 108, 108 
linking to 

directories, 56 
files, 56 

In — make links to file, 56 
local communications, 83 
mesg, 83 
talk, 83 
logging in, 47 
logging out, 47 

login — log in to system, 47 
logout — log out from system, 47 
Is — display file and directory names, 55 

M 

m4 macro processor, 117 
machine products, 7 thru 10 
macro packages for document preparation, 75 
-man, 76 
-ms, 76 

mail — electronic mad, 83 
mailtool, 31 

maintain history — sees,114 
maintain library — ar, 113 
maintain programs — make, 114 
make program maintainer, 114 
-man macro package, 76 
manuals, 135 thru 144 

beginner’s guides, 137 thru 138 
hardware manuals, 144 
programmer’s guides, 139 thru 140 
reference manuals, 143 thru 144 
system administration manuals, 141 thru 142 
manuscript preparation, 73 thru 80 
eheekeq, 79 
eheeknr, 79 
eol, 79 
derof f, 79 
eqn, 76 

macro packages, 75 

-man macro package, 76 

-ms macro package, 76 

nroff, 75 

ptx, 79 

refer, 79 

spell, 79 

tbl, 77 

troff, 75 

mathematical typography — eqn, 76, 79 
mesg — block messages, 83 
mkdir — create directory, 56 
mode 

change, 56 

of files and directories, 53 
more — page through file, 59 


mouse, 21 
move 

directories, 56 
files, 56 

-ms macro package, 76 
mv — more (rename) file, 56 

N 

network administration, 99 thru 102 
network communication, 93, 94 
network file system, 15 
networking, 92 
nice — change priority, 43 
nm — display namelist, 113 
nohup — block hangups, 43 
nrof f, 75 

o 

object code tools, 108 thru 118 
od — dump file, 113 
offline printing— Ipr, 64 
operating system, 13 thru 17, 87 thru 95 

P 

page through file, 59 

parser generator— yacc, 116 

parser generators, 115 thru 117 

pas swd — change password, 47 

password, changing, 47 

paste — paste lines together, 42 

patterns 

scanning for in text files, 66 
perfmeter, 33 
performance 

displaying with perfmeter, 33 
performance analysis, 113 thru 118 
gpr of — caU-graph profile, 114 
prof — execution profile, 113 
t cov — code coverage/statement analysis, 114 
time — time program execution, 113 
Pixrect, 122 
printing text files, 64 
printing text files— Ipr, 64 
printing text files— pr, 64 
process 

block hangups — nohup, 43 
change priority — nice, 43 
divert output— tee, 43 
kill process— kill, 43 
schedule processes — at, 43 
suspend — sleep, 43 
wait, 43 

prof — execution profile, 113 
programmer’s guides, 139 thru 140 
programming interface, 34 
programming languages, 105 thru 108 
adb debug tool, 112 
assembler, 108 
C, 107 thru 108 
cc — C compiler, 107 
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cpp — C preprocessor, 107 
dbx debug tool, 112 
dbxtool debug tool, 110 
gprof — call-graph profile, 114 
indent — format C programs, 108 
link editor, 108, 108 
lint —verify C programs, 107 
object code tools, 108 thru 118 
performance analysis, 113 thru 118 
prof — execution profile, 113 
t GOV — code coverage/statement analysis, 114 
time — time program execution, 113 
programming tools, 108 thru 118 
ar — maintain library, 113 
be desk calculator, 117 
compiler development, 115 thru 117 
dc desk calculator, 117 
lex — lexical generator, 116 
m4 macro processor, 117 
make program builder, 114 
nm — display namelist, 113 
od — dump file, 113 
sees history keeper, 114 
size — display size of object, 113 
strings — search for strings, 113 
strip — strip symbol table, 113 
yaee — parser generator, 116 
ps — display process status, 48 
ptx, 79 

pwd — display name of working directory, 56 

R 

rep — remote copy files, 59 
refer, 79 

reference manuals, 143 thru 144 
regular expressions, 64 
reminder service — e a 1 en da r, 48 
remote communications, 84 
tip, 84 
uuep, 84 

remote copy directories, 59 

remote copy files, 59 

remote file transfers — uuep, 84 

remote login, 48 

Remote Procedure Call, 93 

remote shell, 48 

remotely mounted file systems, 15 
removing 
files, 57 

removing directory, 56 
rename 

directories, 56 
files, 56 

rlogin — remote login, 48 
rm — remove file, 57 
rmdir — remove directory, 56 
RPC, 93 

rsh — remote shell execution, 48 
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scanning for patterns in text files, 66, 67 

sees history maintainer, 114 

schedule processes — at, 43 

screen editor — vi, 64 

search for strings — strings, 113 

sed — sed editing files, 42 

server machine, 15 

server process, 93 

shared libraries, 91 

shell, 17 

Shell-related utilities 

at — schedule processes, 43 
ehmod — chmod executable, 42 
cut — cut lines, 42 
echo — echo arguments, 42 
expr — evaluate expressions, 43 
grep — grep pattern searching, 42 
kill — kill process, 43 
nice — change priority, 43 
nohup — block hangups, 43 
paste — paste lines together, 42 
sed — sed editing files, 42 
sleep — suspend process, 43 
tee — divert output, 43 
test — test arguments, 43 
t r — tr translating characters, 42 
wait — wait on process, 43 
Shells, 39 thru 43 
Bourne Shell, 41 
C shell, 41 
signing off, 47 
signing on, 47 

size — display size of object, 113 
sleep — suspend process, 43 
sockets, 93 
software 

development, 105 

software development tools, 108 thru 118 
a r — maintain library, 113 
be desk calculator, 117 
compiler development, 115 thru 117 
dc desk calculator, 117 
lex — lexical generator, 116 
m4 macro processor, 117 
make program builder, 114 
nm — display namelist, 113 
od — dump file, 113 
sees history keeper, 114 
size — display size of object, 113 
strings — search for strings, 113 
strip — strip symbol table, 113 
yaee — parser generator, 116 
sorting text files, 66 
source code control system, 114 
spell, 79 
spelling checker, 68 
split — split file, 59 
split file, 59 

spooling text files— Ipr, 64 
standards, 92 
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statement analysis, 114 
stream editor — sed, 65 
streams, 94 

strings — search for strings, 113 
strip — strip symbol table, 113 
strip s3mibol table — strip, 113 
sum — checksum file, 60 
Sun user group, 131 
SunCGI, 122 
SunCore, 121 
SunView, 21 thru 36 

clocktool — display time, 34 
commandtool — shell interface, 24 
cmdtool, 26 

dbxtool — interactive debugging, 32 
def aultedit — setting up defaults, 28 
font edit — create fonts, 30 
iconedit — edit icons and cursors, 29 
mailtool—readmail, 31 
perimeter, 33 

shelltool — shell interface, 25 
text edit — text editing, 27 
superuser, 99 

suspend process — s 1 eep, 43 
symbol-table display — nm, 113 
syntax analyzer generators, 115 thru 117 
system administration, 99 thru 102 
system administration manuals, 141 thru 142 
system security, 102 
System V.3, 92 

T 

table formatting — tbl, 77 
tail — display tail of file, 59 
tail of file 

display, 59 

talk — talk to user, 83 
tbl, 77 

tcov — code coverage/statement analysis, 114 
technical documentation, 135 thru 144 
beginner’s guides, 137 thru 138 
hardware manuals, 144 
programmer’s guides, 139 thru 140 
reference manuals, 143 thru 144 
system administration manuals, 141 thru 142 
tee — divert output, 43 
test — test arguments, 43 
text 

editing with text edit, 27 
text files 

checking spelling — spell, 68 

counting things — wc, 66 

display differences between — dif f, 67 

displaying commonality — comm, 68 

editing, 63 thru 69 

editing — ed, 65 

editing — ex, 65 

editing— sed, 65 

editing — vi, 64 

encrypting — crypt, 68 

printing, 64 


text files, continued 

printing — Ipr, 64 
printing — pr, 64 
processing, 63 thru 69 
scanning for patterns — awk, 67 
scanning for patterns — egrep, 66 
scanning for patterns — f grep, 66 
scanning for patterns — grep, 66 
sorting— sort, 66 
translating characters — wc, 66 
text patterns, 64 
textedit, 27 
third-party software, 131 
time — time program execution, 113 
time of day 
display, 48 

displaying with clocktool, 34 
tip — access remote machines, 84 
tr — tr translating characters, 42 
translating characters in text files, 66 
troff, 75 
type of file 

determine, 58 

u 

user, 15 

user access, 47 thru 49 
user environment, 21, 34, 36, 36 
clocktool, 34 
commandtool, 24 
cmdtool, 26 
dbxtool, 32 
def aultedit, 28 
f ontedit, 30 
iconedit, 29 
mailtool, 31 
perimeter, 33 
shelltool, 25 
textedit, 27 
user group, 131 
user interface, 17 
user manuals, 135 thru 144 
UUCP — access remote machines, 84 

V 

verify C programs — lint, 107 

virtual memory, 91 

visual text editor — vi, 64 

w 

w — what are people doing, 48 
wait on process— wait, 43 
who — whos is logged in, 48 
window system, 17, 36, 36 
clocktool, 34 
cmdtool, 24 
cmdtool, 26 
dbxtool, 32 
def aultedit, 28 
f ontedit, 30 
iconedit, 29 
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mailtool, 31 
perfmeter, 33 
shelltool, 25 
textedit, 27 
working directory, 53 
display name of, 56 
workstation products, 7 thru 10 
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XDR, 93 

Y 

yacc—parser generator, 116 
Yellow Pages, 16 
YP, 16 
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